统一下单
用于生成指定数字货币的支付数据,包括收款金额(比如USDT)、收款地址、收款地址二维码等。商户可选择直接跳转至 官方的收银台 供用户支付,也可以使用数据 自定义收银台。在用户支付成功后,系统将即时进行 回调通知。
请求地址:https://域名/apiv2/pay/unifiedorder
请求方式:POST
传参方式:数组
请求参数:
字段名称 | 字段类型 | 必填参数 | 说明 |
---|---|---|---|
appid | string(16) | 必填 | 商户号 |
pay_money | string(16) | 必填 | 金额,精确到小数点后2位。 |
money_type | number(2) | 必填 | 商品金额单位(选择数字): 1:USDT(USD) 2:人民币(CNY) 4:日元(JPY) 7:欧元(EUR) 8:英镑(GBP) 11:港币(HKD) 13:新币(SGD) 16:加元(CAD) 17:澳元(AUD) 18:马币(MYR) 19:比特币(BTC) 20:莱特币(LTC) 21:以太坊(ETH) 当切换货币类型时,会实时转换成等值USDT |
chain_type | number(2) | 必填 | 链路类型(选择数字): 1:USDT-TRC20 2:USDT-ERC20 4:USDT-BNB smart chain 6:USDT-Arbitrum 7:USDC-ERC20 8:USDC-BNB smart chain 9:USDC-Polygon 10:USDC-Arbitrum 12:BTC(Bitcoin) 13:ETH(Ethereum) 14:LTC(Litecoin) 15:TRX(Tron) 16:BNB(BNB smart chain) 19:XRP(Ripple) 20:ADA(Cardano) 99:Paypal (注:需商户后台添加收款地址或电子钱包) |
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_amount | 订单金额,需要支付的金额 |
pay_unit | 订单金额单位 |
pay_precision | 订单金额精度 |
img | 收款地址的二维码 |
chain_type | 链路类型(选择数字): 1:USDT-TRC20 2:USDT-ERC20 4:USDT-BNB smart chain 6:USDT-Arbitrum 7:USDC-ERC20 8:USDC-BNB smart chain 9:USDC-Polygon 10:USDC-Arbitrum 12:BTC(Bitcoin) 13:ETH(Ethereum) 14:LTC(Litecoin) 15:TRX(Tron) 16:BNB(BNB smart chain) 19:XRP(Ripple) 20:ADA(Cardano) 99:Paypal |
pay_url | 官方收银台地址,商户可直接跳转到该地址供用户支付。(注:paypal支付如默认银行卡支付可在地址后加&fundingSource=card) |
en_pay_url | 官方英文收银台地址,商户可直接跳转到该地址供国外用户支付。(注:paypal支付如默认银行卡支付可在地址后加&fundingSource=card) |
iframe_url | 官方嵌入应用中的收银台地址,支持中文和英文,地址参数中添加lang=zh-cn或者lang=en-us |
exchange_rate | 下单时的汇率,商品价类型与支付方式类型之间的汇率 |
time_out | 订单过期时间,时间戳 单位 秒 |
signature | 安全校验签名串。 |