交易请求报文
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 | 异步通知地址 若使用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 ) * 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) | 响应码对应中文注解,用于显示提示 | 必填 |
标准接口会因业务升级需要而新增节点,请在解析返回报文时避免新增未知节点产生的程序出错!