💸Purchasing In-Game Items
Direct Purchase with SHARD
This API limited to 100,000 SHARD per transaction
This API does not need user interaction to confirm the purchase, if you want to have user confirmation, you will need to do it from the game
Pay Transaction with SHARD
POST
[endpoint]/v3/transaction/pay-with-shard
Headers
Name | Type | Description |
---|---|---|
Authorization* | String | Bearer token |
X-Api-Key* | String | API key |
Request Body
Name | Type | Description |
---|---|---|
description* | String | Description of purchase, can be transaction ID generated from your game |
shard_price* | Integer | Price to purchase in SHARD |
Create Item Purchase Transaction
Another method to purchase game item with SHARD is using this API
Create transaction using
/v3/cashier/create
API. Notes: when you set callback_url to your own server, you will receive webhook notification when user completed the payment. Otherwise, you will need to check if the payment has been done via/v3/cashier/check
API.After creating the transaction, you will be given URL to KOMO Cashier
Your game need to open this URL either with webview or open on the browser
If the user does not have enough SHARD to pay, then user can use other payment method to fulfill the transaction
Create Transaction
POST
[endpoint]/v3/cashier/create
Request Body
Name | Type | Description |
---|---|---|
game_transaction_id* | String | Transaction ID for your own purpose |
list_items* | JSON | JSON array for list of purchased items see below format |
callback_url | String | Your own webhook URL to receive confirmation callback |
Check Transaction Status
GET
[endpoint]/v3/cashier/check
Query Parameters
Name | Type | Description |
---|---|---|
komo_tx_id* | String | Komoverse Transaction ID |
Example of list_items payload
Please serialize / stringify the JSON array if you are sending payload as json instead of form-data
Last updated