​
API URL

POST /api/v1/order

​
Request

​
Request Parameters

NameTypeRequiredDescription
pidinteger(int64)YProject id
noncestringY6 random string
timestampinteger(int64)YTimestamp
signstringYSignature
order_idstringYMerchant’s custom unique order ID. No more than 64 characters
order_amountstringYOrder transaction amount. Precision can refer to the decimals field value of the fiat currency information list
order_currencystringYOrder currency code, i.e. ISO 4217 currency code, such as CNY, HKD. Refer to the fiat currency information list
callback_urlstringNCallback address, when order status is changed, a callback notification will be initiated to the corresponding callback_url. Up to 256 characters
remarkstringNRemarks only. No more than 256 characters
valid_timeintegerNTo determine the order expiration time , if not specified, the order expiration time will be 30 minutes as default. Please input in minutes. Minimum is 10 minutes
payer_idstringNPayer unique ID. No more than 32 characters
payer_namestringNPayer’s name. No more than 32 characters
payer_emailstringNPayer email
Request Example
{
    "order_id": "c9231e604da54469a735af3f449c880f",
    "order_amount": "100",
    "order_currency": "CNY",
    "callback_url": "http://xxx.com/order/callback",
    "remark": "payout",
    "payer_id": "p_001",
    "payer_name": "payer",
    "payer_email": "[email protected]"
    "valid_time": 60,
    "pid": 1382528827416576,
    "nonce": "hwlkk6",
    "timestamp": 1688004243314,
    "sign": "d6eef2de79e39f434a38efb910213ba6"
}

​
Response

​
Response Result

NameTypeDescription
codestringReturn code
msgstringReturn message
dataArrayReturn data

​
Response data Array Object

NameTypeDescription
cregis_idstringCregis unique id
order_amountstringOrder transaction amount, defined by the merchant
order_currencystringOrder currency code, i.e. ISO 4217 currency code, such as CNY, HKD, defined by the merchant
created_timeinteger(int64)Order creation time. 13-digit timestamp
expire_timeinteger(int64)Order expiration time. 13-digit timestamp
payment_infoarrayPayment related information

​
payment_info Object

NameTypeDescription
payment_addressstringWallet address that receives payment
token_symbolstringOrder currency
blockchainstringBlockchain name
token_namestringToken name
logo_urlstringToken logo
token_decimalsintegerToken decimal places
receive_amountstringThe amount of the order after exchange rate conversion
receive_currencystringThe order currency code after exchange rate conversion
exchange_ratestringCurrency exchange rate
Response Example
{
    "code": "00000",
    "msg": "ok",
    "data": {
        "cregis_id": "po20240703132452000",
        "order_amount": "100",
        "order_currency": "CNY",
        "created_time":1720430000000,
        "expire_time":1720430174148,
        "payment_info": [
            {
                "payment_address": "TLKz6k1EvMs2sMwTEbqQ6SZfbhzLU7XsQR",
                "token_symbol": "USDT",
                "blockchain": "TRON#Shasta",
                "token_name": "BEP20#Testnet",
                "logo_url": "",
                "token_decimals": 18,
                "receive_amount": "21.20",
                "receive_currency": "USDT",
                "exchange_rate": "0.000001111"
            },
            {
                "payment_address":
                "0xd38c2cf366a731dcbe4a32c7ef24ff96d080ca7e",
                "token_symbol": "USDC",
                "blockchain": "BNB-BSC",
                "token_name": "USDT-BEP20",
                "logo_url": "",
                "token_decimals": 18,
                "receive_amount": "21.30",
                "receive_currency": "USDC",
                "exchange_rate": "0.0000022222"
            }
        ]
    }
}
Currency > QueryPayment > query