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_slugfor InAppPurchase method andfrom_slugfrom 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_entityfor 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_entityfrom UseCurrency method andfrom_entityfrom GetCurrency method.
Since user pays hard currency for a certain item that yield soft currency in return,where_to_slugfor UseCurrency method andfrom_slugfor GetCurrency method must share the same label for the item, whilewhere_to_category_slugfor UseCurrency andfrom_category_slugfor 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.
When recording item or currency that can be acquired from a Random Box,
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.
TentuPlay algorithm provides 10 different types for in-game Object, such as Character, Currency, and Equipment.
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 .InAppPurchase 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
GetCurrency 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}
GetToken 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.
In case of purchasing ad-removal item, input TRUE atis_ad_removefor InAppPurchase method.InAppPurchase 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