统一下单


用于生成指定数字货币的支付数据,包括收款金额(比如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 安全校验签名串。



results matching ""

    No results matching ""