Introduction

Merchant can use this API for create order. In this mode, the whole payment process would be done in merchant pages.

MUST Keep theorderNo from response, it is uniquely identifies for order query.

❗️
Abnormal Transaction Handling Rules

For deposit transactions that are not currently supported by the platform's automatic recognition system, including Internal Transactions, unofficial TON deposits, SUI MoveCall transactions, and other unsupported transaction types, funds cannot be credited automatically. Users may contact customer support and submit the relevant transaction information for manual processing upon verification. A service fee of 47 USDT per transaction will apply.

For cryptocurrencies that require a Memo, Tag, or Payment ID, if the deposit fails to be credited due to incorrect Memo/Tag information, users must provide the relevant transaction details and apply for manual processing. A service fee of 31 USDT per transaction will apply. Requests submitted more than 15 days after the deposit date will not be accepted.

If a withdrawal sent to a third-party platform is returned to the original withdrawal address due to reasons attributable to the receiving platform, users must provide supporting documentation and submit a request for manual asset recovery. A service fee of 47 USDT per transaction will apply. Requests submitted more than 15 days after the return date will not be accepted.

For transactions flagged by KYT (Know Your Transaction) risk monitoring, the platform will conduct a case-by-case review and may require users to provide additional supporting documentation. If the assets need to be returned to the original source address, a service fee of 5 USDT per transaction will apply.

Description of unsupported transfer types

API Description

Request Method: POST

Request Path: /open/api/address/payment

Request Parameters

Body Parameters

Parameter	Sign	Mandatory	Type	Length	Remarks
appId	Y	Y	string	64	AppId is uniqle for merchant
sign	N	Y	string	256	Sign Check on about the sign
merchantOrderNo	Y	Y	string	64	Customer transaction ID, only number
orderAmount	Y	Y	string	64	Order amount (amount unit: USD dollar)
payCurrency	Y	Y	string	64	Currency of payment (check Supported payCurrency)
userId	Y	Y	string	128	UserId is uniqle for user (email / phone number)
paymentTokens	Y	N	string	128	Specify payment token, multiple tokens can be transferred After transfer, users can only use the listed tokens for payment Must be included in the merchant configuration token table Will work on both coin payment and exchange Check on supported token list
userIp	N	Y	string	32	User IP address
paymentNetworks	N	Y	string	32	Specify payment network(separated by comma) Check on supported token list
callbackURL	N	N	string	512	The address receiving order webhook
customParam	N	N	string	512	Merchant custom parameters
expiredTime	N	N	string	32	Time of expire (no more than 172800 second) Example:if the order expires in 1 hour, please upload 3600.
orderModel	N	N	string	32	Order mode (ORDER/RECHARGE) capital letter required ORDER: order mode order would related to order amount strictly, order fails when user payment amount lower than order amount. RECHARGE: recharge mode order would count as success when received user token.And mark the payment amount as final result.

Payment Methods

Payment Method	Payment Method Code
QR Code Payment	WALLET

Supported payCurrency:

Currency	Regular	Example
USD	2 non-zero decimal places after the decimal point	100.12
EUR	2 non-zero decimal places after the decimal point	100.12
HKD	2 non-zero decimal places after the decimal point	100.12
IDR	integer	1000
THB	integer	1000
VND	integer	1000
Token Name(USDT)	The token used for unit configured, 8 non-zero decimal places after the decimal point	1.12345678

Request Parameter Example

{
    "appId":"TEST000001",
    "sign":"TEST000001",
    "merchantOrderNo":"131222222222344345",
    "userId":"[email protected]",
    "orderAmount":"1",
    "payCurrency":"USDT",
    "paymentNetworks":"ETH",
    "paymentTokens":"USDT",
    "userIp":"106.37.115.196",
    "expiredTime":"7200",
    "callbackURL":"http://test.crypto.payment/open/api/callback",
}

Response Parameters

Body Parameters:

Parameter	Type	Details
success	boolean	Success
error	boolean	Error
code	long	Response code
msg	string	Response message
traceId	string	Trace id
model	object	Response details
└─address	string	Payment address
└─orderNo	string	Order number
└─memo	string	memo
└─cryptoVolume	string	Crypto volume

Response Parameter Example

{
    "code": "0",
    "msg": "success",
    "model": {
        "address": "TSVSnP6oPKMxoSvcJdhjNCsPotZ7MtXhy",
        "orderNo": "300217519010756372049",
        "memo":"232323",
        "cryptoVolume": 10.08000000
    },
    "traceId": "686cf5035f549bf8d62da15ea438468e",
    "success": true,
    "error": false
}