接口说明

接口名称 unified_order
是否幂等 是
接口模式 直连
异步通知 是

应用场景

除付款码支付(被扫)场景外,商户系统需先调用该接口在宝付系统生成预支付交易单,返回成功结果之后商户侧按不同场景使用Native、JSAPI、APP等方式调起支付。

注意事项

  • 下单成功后,请依照传入的支付方式,获取接口返回的渠道返回参数扩展字段,从扩展字段中获得不同场景调起支付的业务参数。
  • 下单指定产品类型为SHARING支持支付订单分账,若下单同步传入分账信息,则支付成功后按照商户约定的分账配置进行自动分账。若下单不传入分账信息,则支付成功后,商户可通过确认分账接口进行订单分账。
  • 请求参数支付方式属性扩展字段需要传入的支付属性,请依照传入的支付方式进行传入,详见附录:【支付属性】。
  • 超过支付订单有效时间还未支付成功订单,宝付支付系统会发起关单,并将关单结果通过请求商户侧服务端通知地址告知,或商户发起支付订单查询结果。

接口参数

  • 请求:
字段名 变量名 必填 类型 示例值 描述
代理商商户号 agentMerId 否 S(16) 100000 宝付支付分配的商户号
代理商终端号 agentTerId 否 S(16) 100000 宝付支付分配的终端号
交易商户号 merId 是 S(16) 宝付支付分配的商户号
交易终端号 terId 是 S(16) 宝付支付分配的终端号
交易商户订单号 outTradeNo 是 S(32) 20210315155012 商户系统内部订单号,同一个商户号下唯一
用户实际付款金额 txnAmt 是 I 100 交易金额,单位:分,如:1元则传入100
交易时间 txnTime 是 T 20210315155012 订单交易时间
订单总金额 totalAmt 是 I 100 如包含营销信息,则订单总金额=用户实际付款金额+营销总金额,反之订单总金额=用户实际付款金额
订单有效时间 timeExpire 否 I 72460 订单支付的有效时间,单位:分钟,不传此参数则宝付支付默认有效时间30分钟,允许最大时效7天
产品类型 prodType 是 E ORDINARY 详见附录:【产品类型】
支付方式 payCode 是 E WECHAT_JSAPI 详见附录:【支付方式】
支付方式属性 payExtend 是 C 微信公众号为例:{“sub_openid”:”1231231231”,”sub_appid”:”1231231123”,”body”:”特价手机”} 根据传入的支付方式选择相应的支付属性。
详见附录:【支付属性】
扣费商户号 feeMerId 否 S(16) 100000 该笔交易承担手续费的商户号,默认从交易商户号收取。
二级商户号 subMchId 否 S(64) 微信/支付宝必传,在微信/支付宝报备的二级商户号
服务端通知地址 notifyUrl 否 S(128) https://www.example.com/return_url 付款成功后请求商户侧服务端地址
页面端跳转地址 pageUrl 否 S(128) https://www.example.com/caallback_url 支付完成后跳转的地址:必须是https协议
禁止贷记卡支付 forbidCredit 否 S(1) 0 1:禁止0:不禁止不传默认为0
附加字段 attach 否 S(128) 预留字段
请求方保留域 reqReserved 否 S(128) 预留字段
分账信息 sharingInfo 否 C {“sharingNotifyUrl”:”https://www.example.com/return_url", “sharingDetails”:[{“sharingAmt”:100,”sharingMerId”:”100000”},{“sharingAmt”:200,”sharingMerId”:”100001”}]} JSO格式
详见:分账信息:sharingInfo
营销信息 mktInfo 否 S {“mktAmt”:100,”mktMerId”:”100000”} JSON格式,目前仅支持交易商户承担营销金额
[无营销金额时该字段不上送]
详见:营销信息:mktInfo
风控信息 riskInfo 是 S {“clientIp”:127.0.0.1”,locationPoint”:”53,80”} JSON格式
详见:riskInfo

分账信息:sharingInfo

字段名 变量名 必填 类型 示例值 描述
分账结果通知地址 sharingNotifyUrl 否 S(128) http://www.example.com/notify 宝付分账完成通知商户侧接收地址,不传入此值则不通知
分账明细 sharingDetails 是 C [{“sharingAmt”:100,”sharingMerId”:”100000”},{“sharingAmt”:200,”sharingMerId”:”100001”}] JSON数组
详见:分账明细
分账类型 splitSettlementRules 否 C 传1不分账,传2分账 传2时不传分账信息为延迟分账

分账明细 sharingDetails

字段名 变量名 必填 类型 示例值 描述
分账商户号 sharingMerId 是 S(16) 100000 宝付支付分配的商户号
分账金额 sharingAmt 是 I 100 分账金额,单位:分,如:1元则传入100

营销信息:mktInfo

字段名 变量名 必填 类型 示例值 描述
商户号 mktMerId 是 S(16) 100000 宝付支付分配的商户号
营销金额 mktAmt 是 I 100 营销金额,单位:分,如:1元则传入100

风控信息:riskInfo

字段名 变量名 必填 类型 示例值 描述
用户ip地址 clientIp 是 S(64) 100000 付款用户ip地址
交易商户终端经纬度 locationPoint 否 S(128) 100,100 包含经度和纬度,英文逗号分隔

请求参数示例

{
    "forbidCredit": "0",
    "subMchId": "",
    "prodType": "ORDINARY",
    "terId": "100005196",
    "timeExpire": "120",
    "totalAmt": "100000",
    "outTradeNo": "OTN1772070952058",
    "reqReserved": "请求方保留域",
    "txnTime": "20260226095552",
    "notifyUrl": "http://xxxx.test.com.cn/appv3/addBankResult",
    "merId": "102004459",
    "pageUrl": "",
    "attach": "附加字段",
    "payCode": "ALIPAY_NATIVE",
    "feeMerId": "",
    "txnAmt": "100000",
    "riskInfo": {
        "clientIp": "181.219.133.152",
        "locationPoint": ""
    },
    "payExtend": {
        "subject": "商品名称",
        "area_info": "510812"
    }

}
  • 返回
字段名 变量名 必填 类型 示例值 描述
代理商商户号 agentMerId 否 S(16) 100000 宝付支付分配的商户号
代理商终端号 agentTerId 否 S(16) 100000 宝付支付分配的终端号
商户号 merId 是 S(16) 100000 宝付支付分配的商户号
终端号 terId 是 S(16) 100000 宝付支付分配的终端号
商户订单号 outTradeNo 是 S(64) 20210315155012 商户系统内部订单号,同一个商户号下唯一
订单状态 txnState 否 E WAIT_PAYING 订单状态,详见附录
宝付交易号 tradeNo 否 S(32) 12312312312 与商户订单号对应的宝付侧唯一交易号
请求渠道订单号 reqChlNo 否 S(64) 宝付请求渠道订单号
支付方式 payCode 是 E 原样返回
渠道返回参数 chlRetParam 否 C 根据不同的支付方式返回相应的业务参数,作为商户侧唤起支付,详见附录:【统一下单渠道返回参数】
业务结果 resultCode 是 S(16) SUCCESS 业务处理结果
错误代码 errCode 否 S(32) 当业务结果FAIL时,返回错误代码
错误描述 errMsg 否 S(128) 当业务结果为FAIL时,返回错误描述

返回参数示例

{
    "merId": "102004459",
    "terId": "100005196",
    "resultCode": "SUCCESS",
    "outTradeNo": "OTN1772071283428",
    "txnState": "WAIT_PAYING",
    "tradeNo": "260226111101110006060848",
    "reqChlNo": "26022610011110191231100006206490",
    "payCode": "ALIPAY_NATIVE",
    "chlRetParam": {
        "qr_code": "https://qr.alipay.com/bax01903htsgp8qqaxjp5061",
        "order_id": 260226131006060848
    }
}
作者:yanli  创建时间:2026-05-22 14:45
最后编辑:yanli  更新时间:2026-09-17 19:13