接入API

POST /api/v1/order

请求

请求参数

名称类型是否必须描述
pidinteger(int64)项目编号
noncestring6位随机字符串
timestampinteger(int64)时间戳
signstring签名
order_idstring调⽤⽅唯⼀订单编号【不超过128位字符】
order_amountstring订单交易⾦额【精度可以参考法币信息列表接⼝decimals字段值】
order_currencystring订单货币代码,即ISO 4217货币代码,例如 CNY、HKD,参考法币信息列表接⼝
callback_urlstring回调地址,该订单信息被处理时会向对应的callback_url发起回调通知【最多256位字符】
remarkstring调⽤⽅订单备注信息【不超过256位字符】
valid_timeinteger设置订单超时时间【单位/分钟】,区间【10-60】,如果未填写,系统默认设置为30分钟;
payer_idstring付款⼈id标识【不超过32位字符】
payer_namestring付款⼈姓名【不超过32位字符】
payer_emailstring付款⼈邮箱
请求示例
{
    "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"
}

返回

返回数据

名称类型描述
codestring返回码
msgstring返回信息
dataArray返回数据

返回数据 data 数组对象

名称类型描述
cregis_idstringCregis唯⼀识标
order_amountstring订单交易⾦额【精度可以参考法币信息列表接⼝decimals字段值】
order_currencystring订单货币代码,即ISO 4217货币代码,例如CNY、HKD,参考法币信息列表接⼝
created_timeinteger(int64)订单创建时间【13位时间戳】
expire_timeinteger(int64)订单到期时间【13位时间戳】
payment_infoarray订单相关讯息

payment_info 对象

名称类型描述
payment_addressstring充值地址
token_symbolstring货币标识
blockchainstring货币⽹络
token_namestring货币名称
logo_urlstring货币logo地址
token_decimalsinteger货币精度
receive_amountstring汇率转换后的订单⾦额
receive_currencystring汇率转换后订单货币代码
exchange_ratestring货币汇率
返回示例
{
    "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"
            }
        ]
    }
}