接口说明
| 接口名称 | pre_unified_order |
|---|---|
| 是否幂等 | 是 |
| 接口模式 | 直连 |
| 异步通知 | 是 |
应用场景
支持聚合码支付、H5支付、H5支付（收银台）三种支付场景，商户请求宝付统一下单交易预创建接口，交易预创建成功后，宝付返回商户系统URL链接地址，商户可使用二维码生成工具将该返回值生成二维码，用户点击链接或扫码进行后续支付操作。
注意事项
- 聚合码支付场景支持微信支付、支付宝支付、云闪付支付；
- H5支付场景仅支持微信支付，支付宝支付；
- H5支付（收银台）场景支持微信支付，支付宝支付；
- 下单指定产品类型为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 | 详见附录：产品类型 |
| 是否展示收银台 | cashierFlag | 是 | S(1) | 0 | 0：不展示收银台 1：展示收银台 |
| 支付方式 | payCode | 否 | E | WECHAT_JSAPI | 详见附录：支付方式 |
| 订单类型 | orderType | 否 | I | 7 | 不传默认为普通收单，宝财通2.0模式传入固定值：7 |
| 请求类型 | reqType | 是 | E | APP_PAY | 插件支付传入固定值：APP_PAY |
| 支付方式属性 | payExtend | 是 | C | 微信公众号为例：{“merchant_name”:”商户简称”,”wechat_sub_member_id”:”1231231123”,”goods_name”:”特价手机”} | 根据传入的支付方式选择相应的支付属性。详见附录：支付属性 |
| 扣费商户号 | 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"}]} | JSON数组 |
| -分账结果通知地址 | sharingNotifyUrl | 否 | S(128) | http://www.example.com/notify | 宝付分账完成通知商户侧接收地址，不传入此值则不通知 |
| -分账明细 | sharingDetails | 是 | C | JSON数组 | |
| –商户号 | sharingMerId | 是 | S(16) | 100000 | 宝付支付分配的商户号 |
| –分账金额 | sharingAmt | 是 | I | 100 | 分账金额，单位：分，如：1元则传入100 |
| 营销信息 | mktInfo | 否 | S | {“mktAmt”:100,”mktMerId”:”100000”} | JSON格式，目前仅支持交易商户承担营销金额 |
| -商户号 | mktMerId | 是 | S(16) | 100000 | 宝付支付分配的商户号 |
| -营销金额 | mktAmt | 是 | I | 100 | 营销金额，单位：分，如：1元则传入100 |
| 风控信息 | riskInfo | 否 | S | JSON格式 | |
| -用户ip地址 | clientIp | 是 | S(64) | 100000 | 付款用户ip地址 |
| -交易商户终端经纬度 | locationPoint | 否 | S(128) | 100,100 | 包含经度和纬度，英文逗号分隔 |
- 返回
| 字段名 | 变量名 | 必填 | 类型 | 示例值 | 描述 |
|---|---|---|---|---|---|
| 代理商商户号 | 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 | 与商户订单号对应的宝付侧唯一交易号 |
| 支付方式 | payCode | 否 | E | 原样返回 | |
| 支付令牌 | token | 否 | S(512) | https://test.baofu.com/?token=1232131 | 交易预创建成功返回，可使用二维码生成工具将此返回值生成对应的二维码 |
| 业务结果 | resultCode | 是 | S(16) | SUCCESS | 业务处理结果 |
| 错误代码 | errCode | 否 | S(32) | 当业务结果FAIL时，返回错误代码 | |
| 错误描述 | errMsg | 否 | S(128) | 当业务结果为FAIL时，返回错误描述 |
作者：xiaofeng 创建时间：2025-03-25 15:16
最后编辑：xiaofeng 更新时间：2025-06-05 10:43
最后编辑：xiaofeng 更新时间：2025-06-05 10:43
