Skip to content

统一下单

统一下单接口,适用于微信公众号支付,微信小程序支付,H5 页面拉起支付宝,银联云闪付,银联快捷支付,数字人民币支付的场景。 备注:若用银联快捷下单,务必使用线上终端码,gateway 传 unionpay

请求路径/pay/order
请求方法POST

请求参数

公共参数

参数名称类型必填说明
key标识string开发者唯一标识
time时间戳string当前 unix 时间戳,精确到秒
sign数据签名string数据签名,详见 签名算法
data业务参数JSON string业务参数,详见下例表格

业务参数

参数名称类型必填说明
terminal终端码string终端码,详见控台终端管理
gateway支付通道string支付通道,详见支付通道表
sequence流水号string订单流水号
amount金额string订单金额,保留 2 位小数,如:100.00,最小 0.01
remark备注string订单备注
notifyurl异步通知地址string交易异步通知地址,异步通知返回数据结构与“交易查询”接口返回数据一致
redirecturl支付结束后回调地址string支付结束后回调地址
appidAPPIDstring微信公众号或小程序,支付宝生活号或小程序的 APPID(终端类型为公众号或小程序时必填)
openid微信用户 openidstring微信用户 openid(微信公众号或小程序时必传)
buyerid支付宝用户 buyeridstring支付宝用户 buyerid(支付宝生活号或支付宝小程序时必传,普通 APP,H5 不传)
userid用户标识string用户标识,用户在商户的唯一标识。用于快捷支付再次支付时无须再次输入银行卡号
digital_bank_no数字货币银行编号string01002: 工行,01004: 中行, 01005: 建行,01008:邮储
name用户名称string当 gateway 是 large 时必传
mobile手机号码string手机号码

支付通道表

标识说明
weixin微信支付
alipay支付宝
unionpay云闪付银联快捷
digitalcny数字人民币
large大额支付支持银行清单

请求示例

json
{
  "key": "d787d45a68b48",
  "data": "{\"amount\":\"10.00\",\"appid\":\"wx76cd636ab63648ef\",\"remark\":\"备注\",\"gateway\":\"weixin\",\"notifyurl\":\"https://...\",\"openid\":\"o7DvX6N9B94Y-6BAGEyCEmQYPgSM\",\"sequence\":\"221102738947\",\"terminal\":\"T544357445576893\"}",
  "sign": "b649ef89371dbd5c47686efbabf2e65....",
  "time": 1668671935
}

大额支付请求示例

json
{
  "key": "d787d45a68b48",
  "data": "{
      \"payment\": {
      \"bank\": \"上海汇付支付有限公司-备付金账户\",
      \"bank_code\": \"991290000099\",
      \"card_name\": \"上海汇付支付有限公司\",
      \"card_account\": \"215500687\",
      \"in_acct_flag\": \"242200988360\"
  }"}",
  "sign": "b649ef89371dbd5c47686efbabf2e65....",
  "time": 1668671935
}

返回数据

公共数据

数据名称类型必填说明
code状态码int结果状态码
text操作结果string操作结果,为空时不返回此字段
time时间戳int服务器当前 unix 时间戳,精确到秒
sign数据签名string数据签名
data业务数据JSON string业务数据,详见下例表格

业务数据

数据名称类型必填说明
amount金额string下单金额,精确到 2 位小数,如 1.00
remark备注string备注
gateway支付通道string支付通道,详见支付通道表
payment支付数据JSON支付数据,用于前端发起支付
sequence流水号string下游游水号
terminal终端码string终端码,详见控台终端管理

返回状态

状态说明
0下单成功
1201001下单失败
1201002交易流水号不可重复
1001001系统错误
1001002无效开发者标识
1001003无效签名信息
1001004无效请求时间戳
1001005暂不支持此交易方式
1001051无效支付订单
1002052无效应用终端
1002053无效支付商户
1002054无效支付服务商
1002055无效支付通道
1002056无效支付通道配置
1002057无效支付方式