상점

유료 판매 관련 정보를 대시보드에서 보려면 유료 구매와 관련된 메소드를 호출하세요.

화폐 구매

유저가 현금을 지불하여 게임 내 여러 재화를 획득하는 경우 다음 메소드를 호출하세요.

  • 유저가 현금을 지불하여 젬이나 다이아 같은 게임 내 화폐를 획득하는 경우 InAppPurchase와 GetCurrency를 호출하세요.

    • 유저가 현실의 화폐(현금)를 지불하고 구매하는 경우에만 InAppPurchase 메소드를 사용합니다.

    • from_category_slug에는 해당 유료 구매 상품의 종류(ex. 이벤트, 패키지, 재화, 소모품 등)를 입력합니다.

    • 유료구매로부터 화폐 재화를 획득하였음을 표시하기 위하여 GetCurrency 메소드의 from_entity에는 entity.InAppPurchase라고 입력합니다.

    유료 구매 시 InAppPurchase 메소드의 purchasable_slug 값과 GetCurrency의 from_slug값은 동일한 값을 입력하세요. 아래 표에서는 120 다이아가 예시값으로 되어 있습니다.
    메소드 파라미터 자료형 필수여부 비고

    InAppPurchase

    player_uuid

    string

    필수

    character_uuid

    string

    필수

    purchasable_slug

    string

    필수

    120 다이아

    purchase_quantity

    float

    필수

    1

    purchase_unit_price

    float

    필수

    3300

    purchase_total_price

    float

    필수

    purchase_currency_code

    필수

    currencyCode.KRW

    is_ad_remove

    boolean

    선택

    FALSE
    메소드 파라미터 자료형 필수여부 비고

    GetCurrency

    player_uuid

    string

    필수

    character_uuid

    string

    필수

    currency_slug

    string

    필수

    다이아

    currency_quantity

    float

    필수

    120

    currency_total_quantity

    float

    선택

    9999

    from_entity

    선택

    entity.InAppPurchase

    from_category_slug

    string

    선택

    재화

    from_slug

    string

    선택

    120 다이아

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

    화폐 사용 및 화폐 획득은 게임 내 상점 거래를 통하여 발생하였으므로 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는 동일한 카테고리명을 입력하세요. 아래 표에서는 1000골드와 골드가 각각의 예시값으로 되어 있습니다.
    메소드 파라미터 자료형 필수여부 비고

    UseCurrency

    player_uuid

    string

    필수

    character_uuid

    string

    필수

    currency_slug

    string

    필수

    다이아

    currency_quantity

    float

    필수

    50

    currency_total_quantity

    float

    선택

    9999

    where_to_entity

    선택

    entity.ShopPurchase

    where_to_category_slug

    string

    선택

    골드

    where_to_slug

    string

    선택

    1000골드
    메소드 파라미터 자료형 필수여부 비고

    GetCurrency

    player_uuid

    string

    필수

    character_uuid

    string

    필수

    currency_slug

    string

    필수

    골드

    currency_quantity

    float

    필수

    1000

    currency_total_quantity

    float

    선택

    9999

    from_entity

    선택

    entity.ShopPurchase

    from_category_slug

    string

    선택

    골드

    from_slug

    string

    선택

    1000골드

랜덤박스 구매

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

  • 랜덤박스 구매 시 특정 아이템을 즉시 획득하는 경우 다음 메소드를 호출합니다.

    유료 구매 시 랜덤박스를 통해 획득할 수 있는 아이템 또는 재화에 대해 입력할 때 InAppPurchase 메소드의 purchasable_slug와 GetRandomBox 및 GetEquipment 메소드의 from_slug의 값은 동일해야 합니다. 아래 표에는 일반 총기 뽑기권이 예시값으로 되어 있습니다.
    메소드 파라미터 자료형 필수여부 비고

    InAppPurchase

    player_uuid

    string

    필수

    character_uuid

    string

    필수

    purchasable_slug

    string

    필수

    일반 총기 뽑기권

    purchase_quantity

    float

    필수

    1

    purchase_unit_price

    float

    필수

    3300

    purchase_total_price

    float

    필수

    purchase_currency_code

    필수

    currencyCode.KRW

    is_ad_remove

    boolean

    선택

    FALSE
    메소드 파라미터 자료형 필수여부 비고

    GetRandomBox

    player_uuid

    string

    필수

    character_uuid

    string

    필수

    TentuPlayKeyword._DUMMY_CHARACTER_ID_

    item_slug

    string

    필수

    일반 총기 뽑기권

    item_quantity

    float

    필수

    1

    from_entity

    선택

    entity.InAppPurchase

    from_category_slug

    string

    선택

    무기 상점

    from_slug

    string

    선택

    일반 총기 뽑기권
    메소드 파라미터 자료형 필수여부 비고

    OpenRandomBox

    player_uuid

    string

    필수

    character_uuid

    string

    필수

    TentuPlayKeyword._DUMMY_CHARACTER_ID_

    item_slug

    string

    필수

    일반 총기 뽑기권

    item_quantity

    float

    필수

    1
    메소드 파라미터 자료형 필수여부 비고

    GetEquipment

    player_uuid

    string

    필수

    character_uuid

    string

    필수

    TentuPlayKeyword._DUMMY_CHARACTER_ID_

    item_slug

    string

    필수

    총기

    item_quantity

    float

    필수

    1

    from_entity

    선택

    entity.OpenRandomBox

    from_category_slug

    string

    선택

    일반

    from_slug

    string

    선택

    일반 총기 뽑기권

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

    추후, 유저가 랜덤박스를 오픈하여 특정 Object를 획득할 때 OpenRandomBox 및 GetRandomBox 메소드를 호출합니다.
    메소드 파라미터 자료형 필수여부 비고

    InAppPurchase

    player_uuid

    string

    필수

    character_uuid

    string

    필수

    purchasable_slug

    string

    필수

    알레고리아 상자

    purchase_quantity

    float

    필수

    1

    purchase_unit_price

    float

    필수

    3300

    purchase_total_price

    float

    필수

    purchase_currency_code

    필수

    currencyCode.KRW

    is_ad_remove

    boolean

    선택

    FALSE
    메소드 파라미터 자료형 필수여부 비고

    GetRandomBox

    player_uuid

    string

    필수

    character_uuid

    string

    필수

    TentuPlayKeyword._DUMMY_CHARACTER_ID_

    item_slug

    string

    필수

    알레고리아 상자

    item_quantity

    float

    필수

    1

    from_entity

    선택

    entity.InAppPurchase

    from_category_slug

    string

    선택

    다이아다움 (상점명)

    from_slug

    string

    선택

    알레고리아 상자 × 1

패키지상품 구매

유저가 현금을 지불하고 여러 아이템이 포함된 패키지 상품을 구매한 경우 InAppPurchase 메소드와 함께 획득한 각 오브젝트(예: 캐릭터, 아이템)에 맞는 Get{ 오브젝트 } 메소드를 호출하세요.

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

가령 어떤 유저가 화페 2종("차원석"과 "코스모")과 토큰 1종("프리미엄 티켓")이 포함되어 있는 "월소환 패키지 1"을 구입했다면 아래 표와 같이 InAppPurchase 및 GetToken의 호출과 함께 GetCurrency를 두 번 호출해야 합니다.

메소드 파라미터 자료형 필수여부 비고

InAppPurchase

player_uuid

string

필수

character_uuid

string

필수

TentuPlayKeyword._DUMMY_CHARACTER_ID_

purchasable_slug

string

필수

월소환 패키지 1

purchase_quantity

float

필수

1

purchase_unit_price

float

필수

29000

purchase_total_price

float

필수

purchase_currency_code

필수

currencyCode.KRW

is_ad_remove

boolean

선택

FALSE

메소드

파라미터

자료형

필수여부

비고

재화 A

재화 B

GetCurrency

player_uuid

string

필수

character_uuid

string

필수

TentuPlayKeyword._DUMMY_CHARACTER_ID_

currency_slug

string

필수

차원석

코스모

currency_quantity

float

필수

3300

50

currency_total_quantity

float

선택

99990

9999

from_entity

선택

entity.ShopPurchase

from_category_slug

string

선택

월소환

from_slug

string

선택

월소환 패키지 1
메소드 파라미터 자료형 필수여부 비고

GetToken

player_uuid

string

필수

character_uuid

string

필수

TentuPlayKeyword._DUMMY_CHARACTER_ID_

item_slug

string

필수

프리미엄 티켓

item_quantity

float

필수

2

from_entity

선택

entity.InAppPurchase

from_category_slug

string

선택

월소환

from_slug

string

선택

월소환 패키지 1

광고제거상품 구매

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

광고제거상품을 구매하는 경우 InAppPurchase 메소드의 is_ad_remove 값을 TRUE로 입력해야 합니다.
메소드 파라미터 자료형 필수여부 비고

InAppPurchase

player_uuid

string

필수

character_uuid

string

필수

purchasable_slug

string

필수

광고 제거 아이템 이름

purchase_quantity

float

필수

1

purchase_unit_price

float

필수

16000

purchase_total_price

float

필수

purchase_currency_code

필수

currencyCode.KRW

is_ad_remove

boolean

선택

TRUE