콘솔로 이동

상점

유료 판매 관련 대시보드를 확인하시려면 유료 구매와 관련하여 아래와 같이 메소드를 호출하세요.

화폐 구매

  • 유저가 현금을 지불하여 게임 내 화폐 (ex. 젬, 다이아)를 획득하는 경우 다음 메소드를 호출하세요.

    유저가 현실의 화폐(현금)를 지불하고 구매하는 경우에만 InAppPurchase 메소드를 사용합니다.
    유료 구매 시 InAppPurchase 메소드의 purchasable_slug 값과 GetCurrency 의 from_slug 는 아래와 같이 동일한 값을 입력하세요.
    from_category_slug에는 해당 유료 구매 상품의 종류(ex. 이벤트, 패키지, 재화, 소모품 등)를 입력하세요.
    유료구매로부터 화폐 재화를 획득하였음을 표시하기 위하여 GetCurrency 메소드의 from_entity를 entity.InAppPurchase 로 표기합니다.
    InAppPurchase
    purchasable_slug { 120 다이아 }
    purchase_quantity 1
    purchase_unit_price 3300
    purchase_total_price 3300
    purchase_currency_code currencyCode.KRW
    is_ad_remove { FALSE }

    GetCurrency
    player_uuid { player_uuid }
    character_uuid { character_uuid }
    currency_slug { 다이아 }
    currency_quantity 120
    currency_total_quantity 9999
    from_entity entity.InAppPurchase
    from_category_slug { 재화 }
    from_slug { 120 다이아 }

  • 유저가 Hard Currency(현금 결제로만 얻을 수 있는 화폐)를 지불하여 Soft Currency(게임 플레이를 통해서 얻을 수 있는 화폐)를 획득하는 경우 다음 메소드를 호출하세요.

    화폐 사용 및 화폐 획득은 게임 내 상점 거래를 통하여 발생하였으므로 UseCurrency의 where_to_entity와 GetCurrency 메소드의 from_entity 를 entity.ShopPurchase로 표기합니다.
    특정 상품을 구매하기 위하여 화폐를 사용하고 해당 상품으로부터 화폐를 획득하였으므로 UseCurrency 메소드의 where_to_slug와 GetCurrency의 from_slug 는 동일한 상품명을, UseCurrency 메소드의 where_to_category_slug 와 GetCurrency의 from_category_slug는 동일한 카테고리명을 입력하세요.

    UseCurrency
    player_uuid { player_uuid }
    character_uuid { character_uuid }
    currency_slug { 다이아 }
    currency_quantity 50
    currency_total_quantity 9999
    where_to_entity entity.ShopPurchase
    where_to_category_slug { 골드 }
    where_to_slug { 1000골드 }


    GetCurrency
    player_uuid { player_uuid }
    character_uuid { character_uuid }
    currency_slug { 골드 }
    currency_quantity 1000
    currency_total_quantity 9999
    from_entity entity.ShopPurchase
    from_category_slug { 골드 }
    from_slug { 1000골드 }

랜덤박스 구매

유저가 현금을 지불하고 랜덤박스 아이템을 구매하는 경우 다음 메소드를 호출하세요.

유료 구매 시 랜덤박스를 통해 획득할 수 있는 아이템 또는 재화에 대해 입력할 때 InAppPurchase 메소드의 purchasable_slug 와 GetRandomBox 및 GetEquipment 메소드의 from_slug 의 값은 동일해야 합니다.
  • 랜덤박스 구매 시 특정 아이템을 즉시 획득하는 경우 다음 메소드를 호출합니다.

    InAppPurchase
    purchasable_slug { 일반 총기 뽑기권 }
    purchase_quantity 1
    purchase_unit_price 3300
    purchase_total_price 3300
    purchase_currency_code currencyCode.KRW
    is_ad_remove FALSE


    GetRandomBox
    player_uuid { player_uuid }
    character_uuid TentuPlayKeyword.DUMMY_CHARACTER_ID
    item_slug { 일반 총기 뽑기권 }
    item_quantity 1
    from_entity entity.InAppPurchase
    from_category_slug { 무기 상점 }
    from_slug { 일반 총기 뽑기권 }

    OpenRandomBox
    player_uuid { player_uuid }
    character_uuid TentuPlayKeyword.DUMMY_CHARACTER_ID
    item_slug { 일반 총기 뽑기권 }
    item_quantity 1

    GetEquipment
    player_uuid { player_uuid }
    character_uuid TentuPlayKeyword.DUMMY_CHARACTER_ID
    item_slug { A 총기 }
    item_quantity 1
    from_entity entity.OpenRandomBox
    from_category_slug { 일반 }
    from_slug { 일반 총기 뽑기권 }

  • 랜덤박스 구매 시 특정 랜덤박스를 획득하여, 유저가 오픈 시기를 선택할 수 있는 경우 아래와 같이 메소드를 호출합니다.

    추후, 유저가 랜덤박스를 오픈하여 특정 Object를 획득할 때 OpenRandomBox 및 GetRandomBox 메소드를 호출합니다.
    InAppPurchase
    purchasable_slug { 알레고리아 상자 }
    purchase_quantity 1
    purchase_unit_price 3300
    purchase_total_price 3300
    purchase_currency_code currencyCode.KRW
    is_ad_remove FALSE


    GetRandomBox
    player_uuid { player_uuid }
    character_uuid TentuPlayKeyword.DUMMY_CHARACTER_ID
    item_slug { 알레고리아 상자 }
    item_quantity* 1
    from_entity entity.InAppPurchase
    from_category_slug { 다이아디움(상점이름) }
    from_slug { 알레고리아 상자 X 1 }

패키지상품 구매

  • 유저가 현금을 지불하고 다양한 아이템이 포함된 패키지 상품을 구매한 경우 InAppPurchase 메소드와 함께 획득한 각 Object(ex. 캐릭터, 아이템)에 맞는 Get{ Object 구문 } 메소드를 호출하세요.

    텐투플레이는 게임 내 Object를 Character, Currency, Equipment 등 10개로 구분하고 있습니다.
    Object 획득 메소드 명은 GetEquipment 와 GetCosmetic 과 같이 Get{ Object 구문 } 형식으로 구현되어 있습니다.
    자세한 설명은 Entities 문서를 참고하세요.

    InAppPurchase
    player_uuid { player_uuid }
    character_uuid TentuPlayKeyword.DUMMY_CHARACTER_ID
    purchasable_slug { 월 소환 패키지 1 }
    purchase_quantity 1
    purchase_unit_price 29000
    purchase_total_price 29000
    purchase_currency_code currencyCode.KRW
    is_ad_remove FALSE


    GetCurrency
    player_uuid { player_uuid } { player_uuid }
    character_uuid TentuPlayKeyword.DUMMY_CHARACTER_ID TentuPlayKeyword.DUMMY_CHARACTER_ID
    currency_slug { 차원석 } { 코스모 }
    currency_quantity 3300 50
    currency_total_price 99999 9999
    from_entity entity.InAppPurchase entity.InAppPurchase
    from_category_slug { 월소환 } { 월소환 }
    from_slug { 월 소환 패키지 1} { 월 소환 패키지 1}

    GetToken
    player_uuid { player_uuid }
    character_uuid TentuPlayKeyword.DUMMY_CHARACTER_ID
    item_slug { 프리미엄 티켓 }
    item_quantity 2
    from_entity entity.InAppPurchase
    from_category_slug { 월소환 }
    from_slug { 월 소환 패키지 1 }

광고제거상품 구매

  • 유저가 현금을 지불하고 광고제거 상품을 구매하는 경우 InAppPurchase 메소드를 호출하세요.

    광고제거상품 구매의 경우, InAppPurchase 메소드의 is_ad_remove 값을 TRUE 로 입력해주세요.
    InAppPurchase
    player_uuid { player_uuid }
    character_uuid
    purchasable_slug* { 광고 제거 아이템 }
    purchase_quantity 1
    purchase_unit_price 16000
    purchase_total_price 16000
    purchase_currency_code currencyCode.KRW
    is_ad_remove TRUE