Query Order

Introduction

After user pay for order, merchant can update order status by using this interface.

API Description

Request Method:POST

Request Path:open/api/payment/query

Request Parameter

Parameter

Sign

Mandatory

Type

Length

Remarks

appId

Y

Y

string

64

AEON order number

merchantOrderNo

Y

Y

string

64

merchant order number

sign

N

Y

string

256

sign
Check on about the sign

Response Parameter

Parameter

Sign

Type

Length

Remarks

orderNo

Y

String

64

AEON order number

orderStatus

Y

String

32

Order status

userId

Y

String

128

User ID(email or phone number)

merchantOrderNo

Y

String

64

Merchant order number

orderCurrency

Y

String

32

Currency of order (USD/EUR)

orderAmount

Y

String

16

Amount of order (cent)

payCryptoRate

Y

String

16

Rate of payment crypto (to USDT)

payFiatRate

Y

String

16

Rate of payment fiat (to USD)

payCryptoCurrency

Y

String

32

Cryptocurrency of payment

payCryptoVolume

Y

String

16

Cryptocurrency payment amount

payCryptoNetwork

Y

String

32

Cryptocurrency payment network

address

Y

String

256

Address for user transfer

hxAddress

Y

String

256

Hash address

failReason

Y

String

256

Fail reason

fee

Y

String

16

Transaction fee

customParam

N

Object

512

Expend parameter

settlementAmount

N

string

16

Amount of settlement

settlementCurrency

N

string

16

Currency of settlement

orderTime

N

string

64

UTC+8 time zone, format: yyyy-MM-dd hh:mm:ss

payTime

N

string

64

UTC+8 time zone, format: yyyy-MM-dd hh:mm:ss

payMethod

N

string

16

only affect while using WALLET CONNECT and TON CONNECT
Payment method user used

fromAddress

N

string

256

only affect while using WALLET CONNECT and TON CONNECT
User address for token transfer

Order Status

CodeDetails
INITWaiting for user payment
PROCESSINGDuring the payment process
COMPLETEDPayment success
TIMEOUTPayment cancel
FAILEDPayment failure
DELAY_SUCCESSOrder overtime and payment success
DELAY_FAILEDOrder overtime and payment failed

Fail Reason

CodeDetails
crypto or network inconsistentCurrency or network doesn't match the order
Your payment amount is lower than this orderUser payment amount lower than order amount
Due to fluctuations in the currency price, your payment amount cannot fulfill this orderThe price fluctuation higher than payment slippage

Response Example

SUCCESS

{
    "address": "T9ys1EqRenWmUGCXx4ASDFGHJY1CtA",
    "fee": "2",
    "hxAddress": "461d48491a9cea3df9c63afd14c39f36dbcd49015502bf900081956bf97ae465",
    "merchantOrderNo": "to_4bc9603b12345685",
    "orderAmount": "100",
    "orderCurrency": "USD",
    "orderNo": "300217231234569729",
    "orderStatus": "COMPLETED",
    "payCryptoCurrency": "USDT",
    "payCryptoNetwork": "TRX",
    "payCryptoRate": "1",
    "payCryptoVolume": "102",
    "payFiatRate": "1",
    "settlementAmount": "100",
    "settlementCurrency": "USD",
    "sign": "C615A4F6436CAA308D342E7C49D0164765D3563EC3E3E61F889E9B46BB1E6F1EEEB28280DA233B81E31591C8B1A33C0EE7969CD3",
    "userId": "[email protected]"
}