统一下单

2. 统一下单

接口描述

业务通过统一下单接口可以发起任意三方支付渠道的支付订单。业务系统不必关心该如何调用三方支付,统一下单接口会根据业务系统选择的支付渠道ID,选择对应支付渠道的支付产品,发起下单请求,然后响应给业务系统支付请求所需参数。

接口链接

URL地址:{payUrl}/api/pay/create_order

请求参数

字段名 变量名 必填 类型 示例值 描述
平台ID platId String(30) 1000 支付中心分配的平台ID
商户订单号 mchOrderNo String(30) 20160427210604000490 商户生成的订单号
支付金额 amount int 100 支付金额,单位分
客户端IP clientIp String(32) 210.73.10.148 客户端IP地址
异步回调地址 notifyUrl String(128) http://shop.xx.com/notify.htm 支付结果异步回调URL,只有传了该值才会发起回调
同步请求地址 returnUrl String(128) http://shop.xx.com/return.htm 支付结果同步请求URL
请求时间 reqTime String(30) 20190723141000 请求接口时间, yyyyMMddHHmmss格式
接口版本 version String(3) 1.0 接口版本号,固定:1.0
签名 sign String(32) C380BEC2BFD727A4B6845133519F3AD6 签名值,详见签名算法

响应结果

字段名 变量名 必填 类型 示例值 描述
返回状态码 code String(16) 0 0-处理成功,其他-处理有误,详见错误码
返回信息 msg String(128) 签名失败 具体错误原因,例如:签名失败、参数格式校验错误
以下字段在code=0 时有返回
字段名 变量名 必填 类型 示例值 描述
支付订单号 payOrderId String(30) U12021022311124442600 返回支付系统订单号
商户订单号 mchOrderNo String(30) 20160427210604000490 返回商户传入的订单号
支付跳转地址 payUrl text http://pay.zhifu.com/api/pay/cashier/U12021022311124442600 payMethod=urlJump时存在该参数;支付收银台跳转地址,可直接重定向的URL
转币地址 payAddress String(256) TVZaBC8rZN7DHYUwa4YC28Jsd8K5iF9Bh4 需要转入的USDT地址
通道类型 channelType String(32) TRC20 该地址的USDT类型
费率快照 rateSnapshot String(32) 6.32 当前订单USDT汇率快照
下单金额-RMB amountRmb int 100 下单金额-RMB,单位分
下单金额-USDT amountUsdt String 0.156 下单金额-USDT,单位个
实际付款金额-RMB realAmountRmb int 100 实际付款金额-RMB,单位分
实际付款金额-USDT realAmountUsdt String 0.156 实际付款金额-USDT,单位个
签名信息 sign String(128) CCD9083A6DAD9A2DA9F668C3D4517A84 签名信息