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)交易不支持幂等