Introduction

Merchant can use this API for create order redirect to exchange. Including Binance, Bitget Wallet, Bybit, Crypto.com, KuCoin, Solona, Gate.io, Wallet.

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.

Environmental Information

Sandbox Environment:https://sbx-crypto-payment-api.aeon.xyz/ Production Environment: https://crypto-payment-api.aeon.xyz/

Path

Request Method: POST

Request Path: open/api/payment/customize/V2

Parameters

Request 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
payType	Y	Y	string		Binance=`BINANCE_PAY` Bitget Wallet=`BITGET_PAY` Bybit=`BYBIT_PAY` Crypto.com=`CRYPTO_PAY` KuCoin=`KUCOIN_PAY` Solona=`SOLANA_PAY` Gate.io=`GATE_PAY` Wallet=`WALLET`
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)
redirectURL	N	N	string	512	URL redirect to merchant after order success
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.
subMerchantNo	N	N	string	64	Sub-merchant number
customize	Y	Y	json	512	Extension field
└─token	Y	Y	string	64	Crypto(Default USDT)
└─network	Y	C	string	64	Network (for Gate.io and Wallet)

Request Example

Binance, Bitget Wallet, Bybit, Crypto.com, KuCoin, Solona

{
    "appId": "TEST000001",
    "sign": "TEST000001",
    "merchantOrderNo": "123456789",
    "userId": "[email protected]",
    "orderAmount": "1",
    "payCurrency": "USD",
    "redirectURL": "http://127.0.0.1:8022/open/api/payment2",
    "callbackURL": "http://127.0.0.1:8022/open/api/callback",
    "payType":"BINANCE_PAY",// Exchange
    "customize":{
        "token":"USDT"
    }
}

Gate.io and Wallet

{
    "appId": "TEST000001",
    "sign": "TEST000001",
    "merchantOrderNo": "1234567898",
    "userId": "[email protected]",
    "orderAmount": "1",
    "payCurrency": "USD",
    "redirectURL": "http://127.0.0.1:8022/open/api/payment2",
    "callbackURL": "http://127.0.0.1:8022/open/api/callback",
    "payType":"GATE_PAY",//Gate or Wallet
    "customize":{
        "network":"BSC",
        "token":"USDT"
    }
}

Description of Response 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

Model

Binance

Parameter	Type	Details
orderNo	string	AEON order number
appLink	string	App link of Exchange, redirect user to app
webLink	string	Web link of Exchange, redirect user to web

Bitget Wallet

Parameter	Type	Details
orderNo	string	AEON order number
qrCode	string	QR code

Bybit

Parameter	Type	Details
orderNo	string	AEON order number
qrCode	string	QR code
appLink	string	App link of Exchange, redirect user to app

Crypto.com

Parameter	Type	Details
orderNo	string	AEON order number
appLink	string	App link of Exchange, redirect user to app
webLink	string	Web link of Exchange, redirect user to web

KuCoin

Parameter	Type	Details
orderNo	string	AEON order number
qrCode	string	QR code
appLink	string	App link of Exchange, redirect user to app

Solona

Parameter	Type	Details
orderNo	string	AEON order number
qrCode	string	QR code
appLink	string	App link of Exchange, redirect user to app

Gate.io

Parameter	Type	Details
orderNo	string	AEON order number
webLink	string	Web link of Exchange, redirect user to web

Wallet

Parameter	Type	Details
orderNo	string	AEON order number
number	string	Number of user payment Crypto
memo	string	Memo for transfer crypto (could be null)
address	string	Address for user to transfer crypto

Response Example