统一下单
用于生成指定数字货币的支付数据,包括收款金额(USDT)、收款地址、收款地址二维码等。商户可选择直接跳转至 官方的收银台 供用户支付,也可以使用数据 自定义收银台。在用户支付成功后,系统将即时进行 回调通知。
请求地址:https://qula.top/api/pay/unifiedorder
请求方式:POST
传参方式:数组
请求参数:
字段名称 | 字段类型 | 必填参数 | 说明 |
---|---|---|---|
appid | string(16) | 必填 | 商户号 |
pay_money | string(16) | 必填 | 金额,精确到小数点后2位。 |
money_type | string(16) | 必填 | 单位:1:美元(USD) 2:人民币(CNY) 3:印度卢比(INR) 4:日元(JPY) 5:韩元(KRW),当切换货币类型时,会实时转换成等值USDT |
chain_type | string(16) | 必填 | 链路:1:波场(TRC20) 2:以太坊(ERC20) 3:币安链(BEP20) |
channel_type | string(16) | 必填 | 通道类型:1:系统收款地址 2:个人收款地址,需在商户后台上传自己的钱包地址 |
order_sn | string(32) | 必填 | 用户端自主生成的订单号,在用户端要保证唯一性 |
notify_url | string(500) | 必填 | 接收平台支付异步通知的回调地址。必须为可直接访问的URL,不能带参数、session验证、csrf验证。 |
callback_url | string(500) | 选填 | 即时回调地址,支付成功后,点击返回到的商户地址。务必包含http://开头 |
product_name | string(64) | 选填 | 商品名称 |
pay_username | string(64) | 选填 | 付款人名称 |
attach | string(127) | 选填 | 用户自定义数据,在notify的时候会原样返回 |
signature | string(32) | 必填 | 数据签名 详见签名算法 |
请求返回:
特别提醒:支付后回调函数,并不能标示支付状态。用户需进一步完成验单逻辑
返回参数:
字段名称 | 参数含义 | 必填参数 | 说明 |
---|---|---|---|
code | 请求状态 | 必填 | 1表示提交成功,其它表示提交失败 |
msg | 消息描述 | 必填 | 失败原因 |
data | 订单信息(数据类型:集合) | 必填 | 返回数据,查看下表 |
返回值data参数:
字段名称 | 参数含义 |
---|---|
appid | 商户号 |
order_sn | 商户订单号 |
pay_usdt | 订单金额,需要支付的USDT |
address | 收款地址 |
img | 收款地址的二维码 |
chain_type | 链路:1:波场(TRC20) 2:以太坊(ERC20) 3:币安链(BEP20) |
pay_url | 官方收银台地址,商户可直接跳转到该地址供用户支付。 |
en_pay_url | 官方英文收银台地址,商户可直接跳转到该地址供国外用户支付。 |
time_out | 订单过期时间,时间戳 单位 秒 |
signature | 安全校验签名串。 |