交易请求报文
JSON:
{"request_type": "delay_confirm_request","isspid": "39493002","pos_id": "6666666666","store_id": "6666666666","pos_seq": "QR2021120100000000001","user_id": "user01","system_id": "8888","memo": "订单备注","delay_confirm_request": {"org_pos_seq": "PAY2021120100000000001","notify_url": "https://www.baidu.com/","extend_params": {"split_info": {"keep_amt": "800","split_list": [{"merchant_id": "10000000000001","div_amt": "150"},{"merchant_id": "10000000000002","div_amt": "50"}]}}},"sign": "38C73CFED3B3C6E0ED18AF04E8D34D94"}
XML:
<?xml version="1.0" encoding="GBK"?><business_trans><request_type>delay_confirm_request</request_type><isspid>39493002</isspid><pos_id>6666666666</pos_id><store_id>6666666666</store_id><pos_seq>QR2021120100000000001</pos_seq><user_id>user01</user_id><system_id>8888</system_id><memo>订单备注</memo><delay_confirm_request><org_pos_seq>PAY2021120100000000001</org_pos_seq><notify_url><![CDATA[https://www.baidu.com/]]></notify_url><extend_params><![CDATA[{"split_info": {"keep_amt": "800","split_list": [{"merchant_id": "10000000000001","div_amt": "150"},{"merchant_id": "10000000000002","div_amt": "50"}]}}]]></extend_params></delay_confirm_request></business_trans>
交易请求报文说明
| 节点名称 | 中文名称 | 类型 | 说明 | 是否必填 |
|---|---|---|---|---|
| sign | 报文签名 | String(32) | 请求报文格式为JSON时必填 计算签名方式请看2.1章节 | 可选 |
| request_type | 请求类型 | String(32) | 固定值:delay_confirm_request | 必填 |
| isspid | 商户号 | String(8) | 翼码商户号,由翼码提供 | 必填 |
| pos_id | 终端号 | String(20) | 商户自定义终端号 | 必填 |
| store_id | 门店号 | String(20) | 商户自定义门店号 | 必填 |
| pos_seq | 延时确认请求流水号 | String(32) | 同一个翼码商户号下唯一,不可重复使用,且大于12位 | 必填 |
| user_id | 操作员标识 | String(20) | 操作员号 | 可空 |
| system_id | 系统平台号 | String(4) | 翼码平台号 | 必填 |
| memo | 订单备注 | String(128) | 可空 | |
| delay_confirm_request ->org_pos_seq | 支付请求流水号 | String(32) | 被确认的支付请求流水号 | 必填 |
| delay_confirm_request ->notify_url | 异步通知地址 | String | 4.29.延时分账结果通知 若使用XML报文时请使用CDATA标签包裹内容 | 可选 |
| delay_confirm_request ->extend_params | 扩展参数 | JSON | 用于扩展一些特殊的支付参数字段 若使用XML报文时请使用CDATA标签包裹内容 详细参数见下表 | 可空 |
extend_params 扩展参数 (JSON)
| JSON节点 | 类型 | 说明 | 是否必填 | 范例 |
|---|---|---|---|---|
| split_info | JSON | 分账信息 该节点与分账功能相关具体联系业务确认开通功能; 当分账信息参与方超过7个时,延时交易确认查询接口中的响应码可能会返回处理中的响应码,出现此响应码时需要调用延时交易确认查询接口查询终态 | 必填 |
split_info 分账信息
| JSON节点 | 类型 | 说明 | 是否必填 | 范例 |
|---|---|---|---|---|
| keep_amt | String | 分账方自留金额,单位为分,可传0表示不自留 当支付单类型是账户支付时传0 | 必填 | 1000 |
| split_list | Array | 分账明细 | 可空 |
延时交易确认支持多次部分分账
keep_amt 传0代表本笔分账交易不分账给分账方
split_list 不传代表本笔分账交易不分账给分账接收方
keep_amt 传0时,split_list 不可为空
split_list 分账明细
| JSON节点 | 类型 | 说明 | 是否必填 | 范例 |
|---|---|---|---|---|
| merchant_id | String | 分账接收方的分账商户号 当支付单类型不是账户支付时必填 | 可选 | 10000000000001 |
| seller_account | String | 分账接收方的收款账户编号 当支付单类型是账户支付时可选 分账商户号与收款账户编号二选一必填 | 可选 | 6666000116230109 |
| div_amt | String | 分账金额,单位为分,必须大于0 | 必填 | 1000 |
一笔订单的可确认金额(自留金额+分账金额总和) = 订单金额 - 交易手续费
一笔订单的最大可分金额(分账金额总和) = ( 订单金额 - 交易手续费 ) * 最大分账比例
保留小数点后两位,第三位及之后的位数舍去,不做进位
最大分账比例的申请请联系运营人员
例:
订单金额100元,交易手续费0.3元,最大分账比例75%
可确认金额 = 100 - 0.3 = 99.7元
最大可分金额 = ( 100 - 0.3 ) * 0.75 = 74.775 舍去第三位 = 74.77元
extend_params 样例:
{"split_info": {"keep_amt": "800","split_list": [{"merchant_id": "10000000000001","div_amt": "150"},{"merchant_id": "10000000000002","div_amt": "50"}]}}
交易返回报文
JSON:
{"response_type": "delay_confirm_response","isspid": "39493002","pos_id": "6666666666","pos_seq": "QR2021120100000000001","trans_time": "20181214152755","sys_seq": "f135e20440ea261b","result": {"id": "0000","comment": "交易成功"},"sign": "F3417D5E9CEF3AE32110C7EFBF5AB400"}
XML:
<?xml version="1.0" encoding="GBK"?><business_trans><response_type>delay_confirm_response</response_type><isspid>39493002</isspid><pos_id>6666666666</pos_id><pos_seq>QR2021120100000000001</pos_seq><sys_seq>f135e20440ea261b</sys_seq><trans_time>20181214152755</trans_time><result><id>0000</id><comment>成功</comment></result></business_trans>
交易返回报文说明
标准接口会因业务升级需要而新增节点,请在解析返回报文时避免新增未知节点产生的程序出错!
| 节点名称 | 中文名称 | 类型 | 说明 | 是否必填 |
|---|---|---|---|---|
| sign | 报文签名 | String(32) | 返回报文格式为JSON时必填 计算签名方式请看2.1章节 | 可选 |
| response_type | 返回类型 | String(32) | 固定值:delay_confirm_response | 必填 |
| isspid | 商户号 | String(8) | 翼码商户号,由翼码提供 | 必填 |
| pos_id | 终端号 | String(20) | 商户自定义终端号 | 必填 |
| pos_seq | 延时确认请求流水号 | String(32) | 延时确认请求流水号,和请求报文相同 | 必填 |
| sys_seq | 随机串号 | String(16) | 随机生成串号,仅用于日志跟踪用,不保存 | 必填 |
| trans_time | 接口返回时间 | String(14) | 接口返回时间,格式:yyyyMMddHHmmss | 必填 |
| result ->id | 响应码 | String(4) | 0000:成功 9998:处理中,需调用延时交易确认查询接口查询 其它值代表失败,错误信息说明见“响应码解释”字段 | 必填 |
| result ->comment | 响应码解释 | String(64) | 响应码对应中文注解,用于显示提示 | 必填 |
标准接口会因业务升级需要而新增节点,请在解析返回报文时避免新增未知节点产生的程序出错!


