Skip to main content
API docs by Redocly

KryptoGO Payment API (1.0.0)

Download OpenAPI specification:Download

KryptoGO Support: contact@kryptogo.com URL: https://kryptogo.com/docs/official-contact-channels License: Proprietary

Introduction

The KryptoGO Payment API allows organizations to seamlessly integrate cryptocurrency payments into their applications. Whether you're building a game, e-commerce platform, or any digital service, this API enables you to accept crypto payments and process withdrawals without managing complex blockchain infrastructure.

Typical Flow

  1. Payment Processing - When your user want to top up or make purchases, create a payment intent
  2. Status Monitoring - Track the status of payment intents, with updates via callback or polling
  3. Token Transfer - Use the Asset Pro Transfer API to transfer tokens to users when they want to withdraw funds

Use Cases

  • Gaming: Enable players to purchase in-game assets and withdraw earnings
  • E-commerce: Accept cryptocurrency payments for products and services
  • Digital Services: Offer subscription payments with crypto
  • Marketplaces: Facilitate buyer-seller transactions using blockchain technology
  • Loyalty Programs: Distribute rewards tokens to customers

Payment

Payment Intent API for creating and managing payment requests

Create payment intent

Create a new payment intent when a user wants to top up their account or make a purchase using cryptocurrency.

Authorizations:
StudioApiKey
header Parameters
X-Client-ID
required
string

OAuth client ID

Origin
required
string

Your application's domain

Request Body schema: application/json
required
fiat_amount
required
string

The amount in fiat currency

fiat_currency
required
string
Enum: "TWD" "USD"

The fiat currency code

callback_url
string

The URL to receive the payment result update

order_data
object

Arbitrary data about the order (e.g., order_id, item_id). Will be returned unaltered in callbacks. Max 1000 characters when marshalled.

group_key
string

A custom identifier for the payment intent, can be used to classify the payment intent.

Responses

Callbacks

Request samples

Content type
application/json
{
  • "fiat_amount": "300.0",
  • "fiat_currency": "TWD",
  • "callback_url": "https://example.com/callback",
  • "order_data": {
    },
  • "group_key": "buy_stone_with_usdt"
}

Response samples

Content type
application/json
{
  • "code": 0,
  • "data": {
    }
}

Callback payload samples

Callback
POST: Payment result update
Content type
application/json
{
  • "payment_intent_id": "0h39QkYfZps7AUD1xQsj3MDFVLIMaGoV",
  • "client_id": "9c5a79fc1117310f976b53752659b61d",
  • "fiat_amount": "300.0",
  • "fiat_currency": "TWD",
  • "payment_deadline": 1715462400,
  • "status": "success",
  • "payment_chain_id": "arb",
  • "symbol": "USDT",
  • "crypto_amount": "2.53",
  • "payment_tx_hash": "string",
  • "refund_tx_hash": "0x1234567890abcdef",
  • "received_amount": "8.75",
  • "aggregated_amount": "8.75",
  • "refund_amount": "8.75",
  • "order_data": {
    },
  • "callback_url": "https://example.com/callback",
  • "group_key": "buy_stone_with_usdt"
}

Get payment intent status

Check the current status of a specific payment intent.

Authorizations:
StudioApiKey
path Parameters
id
required
string

The payment intent ID

header Parameters
X-Client-ID
required
string

OAuth client ID

Origin
required
string

Your application's domain

Responses

Response samples

Content type
application/json
{
  • "code": 0,
  • "data": {
    }
}

List payment intents for organization

Get all payment intents for your organization.

Authorizations:
StudioApiKey
query Parameters
page_number
integer
Default: 1

Page number for pagination

page_size
integer
Default: 10

Number of items per page

client_id
string

Filter by client ID

status
Array of strings
Items Enum: "pending" "success" "expired" "insufficient_not_refunded" "insufficient_refunded"

Filter by payment intent status. Multiple status values can be provided.

group_key
string

Filter by group key. Uses substring matching (fuzzy search) - will return results where group key contains this value.

Responses

Response samples

Content type
application/json
{
  • "code": 0,
  • "data": {
    }
}

Withdrawal

APIs for managing token transfers and supported tokens

Transfer tokens

Transfer tokens to a user's wallet when they want to withdraw funds from your application. This API can be used for game payouts, user withdrawals, or automated rewards distribution.

Authorizations:
StudioApiKey
Request Body schema: application/json
required
chain_id
required
string

The blockchain network ID (e.g., "eth", "arb")

contract_address
required
string
amount
required
string
wallet_address
required
string

Responses

Request samples

Content type
application/json
{
  • "chain_id": "string",
  • "contract_address": "0xdac17f958d2ee523a2206206994597c13d831ec7",
  • "amount": "100.123",
  • "wallet_address": "0x3fE5aC82B997255b8226abb6aEfd91f405fe2e8e"
}

Response samples

Content type
application/json
{
  • "code": 0,
  • "data": {
    }
}