2.3.6 支付类交易
交易URL
生产环境: https://esc.baofu.com/gateway/api/acquiring/v2
测试环境:https://v-esc-service.baofu.com/gateway/api/acquiring/v2
请求报文
data_content:
序号 | 域名 | 变量名 | 必填 | 字段类型 | 备注 |
---|---|---|---|---|---|
1. | 商户订单号 | trans_id | M | Max50Text | 唯一订单号,yyyyMMdd(8位系统当前日期)+字母/数字,系统对前8位进行强校验,未支付成功的订单号可重复提交,重复提交时交易参数不得发生变化 |
2. | 签约协议号 | protocol_no | M | Max126Text | 加密方式:Base64转码后,使用数字信封指定的方式和密钥加密 |
3. | 子商户号 | sub_member_id | M | Max16Text | |
3. | 交易金额 | txn_amt | M | Max12Numeric | 单位:分 例:1元则提交100 |
4. | 风控参数 | risk_item | O | 不限制 | 字符串,详细参数见风控参数字段说明(通用参数、电商、互金消金、航旅、酒店、宝信、游戏、大宗) |
5. | 交易成功通知地址 | return_url | O | Max128Text | |
6. | 手续费承担方商户号 | fee_member_id | O | Max32Text | 如需要其他商户号承担上述商户号的手续费,可联系运营人员配置后,在此处传参手续费承担方的商户号信息 |
7. | 计费商户号 | call_fee_member_id | O | Max32Text | 按照指定的商户号费率计算手续费 |
8. | 分账信息 | share_info | C | share_info | 需要分账时必传;详见:分账信息share_info eg: {share_details:[{“share_amt”:100,”member_id”:”100000”},{“share_amt”:200,”member_id”:”100001”}], share_notify_url:”www.xxx.com”} |
9. | 扩展字段 | extended | O | 不限制 | 预留字段 |
10. | 商品信息 | goods_info | O | Max512Text | |
11. | 渠道参数 | channel_business | O | 不限 | 特定渠道业务时上传 |
分账信息 share_info集合(分账业务必须填)
序号 | 域名 | 变量名 | 必填 | 字段类型 | 备注 |
---|---|---|---|---|---|
1. | 分账明细 | share_details | M | Max1024Text | 数组 详见:分账明细:share_details eg: [{“share_amt”:100,”member_id”:”100000”},{“share_amt”:200,”member_id”:”100001”}] |
2. | 分账通知地址 | share_notify_url | O | Max128Text | 分账成功之后通知地址 |
3. | 附加信息 | reserverd | O | Max255Text |
分账明细 share_details(分账业务必须填)
序号 | 域名 | 变量名 | 必填 | 字段类型 | 备注 |
---|---|---|---|---|---|
1. | 商户号 | member_id | M | Max16Text | |
2. | 分账金额 | share_amt | M | Max12Numeric | 单位:分,例:1元则提交100 |
渠道参数 channel_business(特定的渠道业务可上传)
- 通道ICBC_ZL_001、ICBC_ZL_002
序号 | 域名 | 变量名 | 必填 | 字段类型 | 备注 |
---|---|---|---|---|---|
1. | 摘要 | summary | C | Max20Text | 非必输,若上送则会与协议表中预定义的摘要进行匹配校验,详情请联系业务人员确认 |
返回报文
data_content:
序号 | 域名 | 变量名 | 必填 | 字段类型 | 备注 |
---|---|---|---|---|---|
1. | 业务应答码 | biz_resp_code | C | Max32Text | 具体参见:应答码 |
2. | 业务应答说明 | biz_resp_msg | C | Max128Text | |
3. | 订单状态 | order_status | C | code | 参见: 支付状态 |
4. | 成功金额 | succ_amt | C | Max12Numeric | 单位:分 例:1元则100 |
5. | 交易完成时间 | succ_time | C | ISODateTime | 系统得到通道应答的时间 |
6. | 银企云订单号 | order_id | C | Max32Text | 银企云订单号 |
7. | 商户订单号 | trans_id | R | Max50Text | |
8. | 渠道订单号 | channel_order_id | C | Max64Text | 交易成功时返回 |
9. | 扩展字段 | reserved | O | 不限制 | 预留扩展字段 |
10. | 渠道返回扩展字段 | channel_rtn | O | 不限制 | 预留字段 |
说明:
A)支付交易终态判断逻辑
订单状态order_status字段为判断支付订单结果的唯一标识(”S”-成功,”F”-失败),若该字段值为(”I”-初始,”P”-处理中)或未返回,请15分钟后发起支付结果查询类交易。
B)交易不支持幂等