统一下单
用于生成指定数字货币的支付数据,包括收款金额(USDT)、收款地址、收款地址二维码等。商户可选择直接跳转至 官方的收银台 供用户支付,也可以使用数据 自定义收银台。在用户支付成功后,系统将即时进行 回调通知。
请求地址:/pay/order
请求方式:POST
请求参数:
字段名称 | 字段类型 | 必填参数 | 说明 |
---|---|---|---|
appid | string(16) | 必填 | 商户号 |
pay_money | string(16) | 必填 | 金额(元),精确到小数点后2位。 |
money_type | string(16) | 必填 | 单位:1:USDT 2:CNY,当单位为CNY时,会实时转换成等值USDT |
order_sn | string(64) | 必填 | 商户自主生成的订单号,要保证唯一性,仅支持字母、数字、下划线 |
notify_url | string(500) | 必填 | 接收平台支付异步通知的回调地址。必须为可直接访问的URL,不能带参数、session验证、csrf验证。 |
callback_url | string(500) | 选填 | 即时回调地址,支付成功后,点击返回到的商户地址。务必包含http://开头 |
product_name | string(64) | 选填 | 商品名称 |
pay_username | string(64) | 选填 | 付款人名称 |
attach | string(127) | 选填 | 用户自定义数据,在notify的时候会原样返回 |
lang | string(64) | 选填 | 收银台使用的语言, zh-cn:简体中文(默认), zh-cht:繁体, en:英文, 不传则根据用户浏览器的语言设置自动匹配 |
signature | string(32) | 必填 | 数据签名 详见签名算法 |
请求返回:
特别提醒:支付后回调函数,并不能标示支付状态。用户需进一步完成验单逻辑
返回参数:
字段名称 | 参数含义 | 必填参数 | 说明 |
---|---|---|---|
code | 请求状态 | 必填 | 1表示提交成功,其它表示提交失败 |
msg | 消息描述 | 必填 | 失败原因 |
data | 订单信息(数据类型:集合) | 必填 | 返回数据,查看下表 |
返回值data参数:
字段名称 | 参数含义 |
---|---|
appid | 商户号 |
order_sn | 商户订单号 |
pay_usdt | 订单金额,需要支付的USDT |
pay_money | 订单金额 |
usdt_cny | 当前汇率 |
address_list | 收款地址列表,格式为json数组字符串,注意:验证签名时,需要把该字段当作字符串处理,详细字段参考'返回值address_list参数' |
pay_url | 官方收银台地址,商户可直接跳转到该地址供用户支付。 |
en_pay_url | 官方英文收银台地址,商户可直接跳转到该地址供国外用户支付。 |
time_out | 订单过期时间,时间戳 单位 秒 |
signature | 安全校验签名串。 |
返回值address_list参数:
address | 收款地址 |
---|---|
img | 收款地址的二维码 |
chain_type | 链路:1:波场(TRC20) 2:以太坊(ERC20) |