Create Order

Introduction

Generate an order through this interface, we would return the web url, and the user pay at front end.

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

API Description

Request Method:POST

Request Path:open/api/payment/V2

Parameters

Request parameters

Parameter

Sign

Mandatory

Type

Length

Remarks

appId

Y

Y

string

64

AppId is unique for merchant

sign

N

Y

string

256

Sign Check on About the sign

merchantOrderNo

Y

Y

string

64

Only number of customer transaction ID

orderAmount

Y

Y

string

64

Order amount (amount unit: dollar) example: 1=1.00

payCurrency

Y

Y

string

64

Currency of payment (EUR / USD)

userId

Y

Y

string

128

UserId is unique for user (email / phone number)

paymentTokens

Y

N

string

128

  1. Specify payment token, multiple tokens can be transferred
  2. After transfer, users can only use the listed tokens for payment
  3. Must be included in the merchant configuration token table
  4. Will work on both coin payment and exchange Check supported token

redirectURL

N

N

string

512

The redirection address after the successful purchase

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 (second)

payType

N

N

string

32

Type of payment, check on Pay Type

paymentNetworks

N

N

string

32

Specify payment network(separated by comma)
Check supported token

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.

paymentExchange

Y

N

string

512

Payment method require configuration exchange method/ wallet method.
Specify the exchange/ wallet, multiple transfers are acceptable. Users can only use the specified exchange/wallet to pay under the exchange payment/wallet payment method by sending this parameter. Check on Exchange codes and Wallet codes

Pay Type

Payment MethodPayment Method Code
QR Code PaymentWALLET
Binance PayBINANCE_PAY
ExchangeEXCHANGE
Wallet PaymentWALLET_PAY

Exchange Codes

ExchangeCode
Kraken16f021b0-f220-4bbb-aa3b-82d423301957
Paxos2fdd678d-8ece-49f5-992c-a1d7c4367833
Bybit3b8d8911-b2c0-4c1a-9127-675653c21960
Coinbase47624467-e52e-4938-a41a-7926b6c27acf
Robinhood6e192ebb-a073-4055-bbd7-d644539c9a20
Binance9226e5c2-ebc3-4fdd-94f6-ed52cdce1420

Wallet Codes

WalletCode
Metamask34aeb688-decb-485f-9d80-b66466783394
Trust Wallet7f4307ea-58c6-4678-9eb2-fec205de5401
Coinbase Wallet6132432e-d59c-4555-9844-cea0ce600ba3
Uniswap Wallet58c89cae-b2ff-4176-85a3-1d1f7795cbe0
Blockchain Walletd22f63a1-50c0-4439-961c-870fc430c979
Bitcoin.com Walletf4b147b5-d166-4e6e-b4c1-e59d401cde11
Crypto.com Wallet Primee16f1dc8-7577-4170-a67f-5ebb266e410e
imToken7f523342-0bc6-4465-a035-bb4d2ed693ed
Rainbow8a60d227-2825-4158-b14b-3c8443a2b681

Pay Currency

CurrencyFormat DescriptionExample
USD2 non-zero decimal places after the decimal point100.12
EUR2 non-zero decimal places after the decimal point100.12
HKD2 non-zero decimal places after the decimal point100.12
IDRInteger1000
THBInteger1000
VNDInteger1000
Token Name (USDT)The token used for unit configuration, 8 non-zero decimal places1.12345678

Request Example

{
    "appId": "TEST000001",
    "callbackURL": "https://90fc-111-10-154.ngrok-free.app/v1/xxxxx",
    "expiredTime": "60",
    "merchantOrderNo": "17236123450000",
    "orderAmount": "100",
    "orderModel": "ORDER",
    "payCurrency": "USD",
    "paymentTokens": "ETH",
    "redirectURL": "https://50xxxxx832.vicp.fun/platform/xxxxx",
    "sign": "07572BA8F945685E6BB57FC21FDE74E7217A015E00FD56176F3A500465817B33FAC086DA7887AC266BA8518960F0FE208DE1A8E105978B185A8D136DD0F6",
    "userId": "[email protected]"
}

Description of Response Parameters

ParameterTypeDetails
successbooleanSuccess
errorbooleanError
codelongResponse code
msgstringResponse message
traceIdstringTrace id
modelobjectResponse details
checkout addressstringcheckout web address

Response Example

{
    "code": "0",
    "model": {
        "orderNo": "300217236173748123456",
        "webUrl": "https://crypto-payment.aeon.org?orderNum=30012345678923456"
    },
    "msg": "success",
    "traceId": "66bc505e9f97eafb6ca69d123471cb"
}