InGame Purchase
Call the purchase related methods below to check In-app purchase dashboard on our console.
Purchase Currency
-
Call the methods below when a user pays cash for in-game currency such as gem or diamond.
InAppPurhcase method is called only when a user pays in cash (i.e. real money).
When paid in cash,purchasable_slug
for InAppPurchase method andfrom_slug
from GetCurrency method must share the same input value as shown below.
Input the type of purchased item such as event, package, currency, or consumable atfrom_category_slug
.
To record that purchased game currency is paid in cash, input entity.InAppPurchase atfrom_entity
for GetCurrency method.InAppPurchase purchasable_slug { 120 diamonds } 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 { diamonds } currency_quantity 120 currency_total_quantity 9999 from_entity entity.InAppPurchase from_category_slug { currency } from_slug { 120 diamonds }
-
Call the methods below when a user pays Hard Currency (currency that can only be acquired through cash payment) to acquire Soft Currency (currency that can be acquired through game play).
Since the purchase of soft currency by hard currency takes place in an in-app store, input entity.ShopPurchase atwhere_to_entity
from UseCurrency method andfrom_entity
from GetCurrency method.
Since user pays hard currency for a certain item that yield soft currency in return,where_to_slug
for UseCurrency method andfrom_slug
for GetCurrency method must share the same label for the item, whilewhere_to_category_slug
for UseCurrency andfrom_category_slug
for GetCurrency must share the same label for the item category.UseCurrency player_uuid { player_uuid } character_uuid { character_uuid }
currency_slug { diamonds } currency_quantity 50 currency_total_quantity 9999 where_to_entity entity.ShopPurchase where_to_category_slug { gold } where_to_slug { 1000 gold }
GetCurrency player_uuid { player_uuid } character_uuid { character_uuid }
currency_slug { gold } currency_quantity 1000 currency_total_quantity 9999 from_entity entity.ShopPurchase from_category_slug { gold } from_slug { 1000 gold }
Purchase Random Box
Call the methods below when a user pays cash to purchase Random Box item.
purchasable_slug
for InAppPurchase method and from_slug
for GetRandomBox and GetEquipment method must share the same input value.
-
Call the methods below when a specific item is acquired immediately after purchasing a Random Box.
InAppPurchase purchasable_slug { common firearm random box } 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 { common firearm random box } item_quantity 1 from_entity entity.InAppPurchase from_category_slug { firearm store }
from_slug { common firearm random box }
OpenRandomBox player_uuid { player_uuid } character_uuid TentuPlayKeyword.DUMMY_CHARACTER_ID item_slug { common firearm randombox } item_quantity 1
GetEquipment player_uuid { player_uuid } character_uuid TentuPlayKeyword.DUMMY_CHARACTER_ID item_slug { A firearm } item_quantity 1 from_entity entity.OpenRandomBox from_category_slug { common } from_slug { common firearm random box }
-
Call the methods below when a certain random box, acquired from purchase, can be opened any time at user's disposal.
Call OpenRandomBox and GetRandomBox methods when a user opens a certain random box in the future to acquire a certain Object.
InAppPurchase purchasable_slug { Alegoria Box } 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 { Alegoria Box } item_quantity* 1 from_entity entity.InAppPurchase from_category_slug { Diadium (name for the store) }
from_slug { Alegoria Box X 1 }
Purchase Package Item
Call InAppPurchase method along with Get{ Object type } method when a user pays cash to purchase a package item with multiple items included.
For each type of Object, you can call the method in Get{ Object type } format such as GetEquipment or GetCosmetic.
If you would like more in-depth explanation about Object, please refer to Entities .
player_uuid | { player_uuid } |
---|---|
character_uuid | TentuPlayKeyword.DUMMY_CHARACTER_ID |
purchasable_slug
{ monster summoning package 1 } |
|
purchase_quantity | 1 |
purchase_unit_price
29000 |
|
purchase_total_price | 29000 |
purchase_currency_code | currencyCode.KRW |
is_ad_remove | FALSE |
player_uuid | { player_uuid } | { player_uuid } |
---|---|---|
character_uuid | TentuPlayKeyword.DUMMY_CHARACTER_ID | TentuPlayKeyword.DUMMY_CHARACTER_ID |
currency_slug | { gem } | { cosmo } |
currency_quantity | 3300 | 50 |
currency_total_price | 99999 | 9999 |
from_entity | entity.InAppPurchase | entity.InAppPurchase |
from_category_slug | { monster summon } | { monster summon } |
from_slug | { monster summoning package 1} | { monster summoning package 1} |
player_uuid | { player_uuid } |
---|---|
character_uuid | TentuPlayKeyword.DUMMY_CHARACTER_ID |
item_slug | { premium ticket } |
item_quantity | 2 |
from_entity | entity.InAppPurchase |
from_category_slug | { monster summon } |
from_slug | { monster summoning package 1 } |
Purchase Ad-Removal
Call InAppPurchase method when a user pays cash to purchase ad-removal item.
is_ad_remove
for InAppPurchase method.
player_uuid | { player_uuid } |
---|---|
character_uuid | |
purchasable_slug* | { ad_removal item } |
purchase_quantity | 1 |
purchase_unit_price | 16000 |
purchase_total_price | 16000 |
purchase_currency_code | currencyCode.KRW |
is_ad_remove | TRUE |