业务说明
本接口请求方为翼码系统,接收方为商家系统。
支持的交易类型:
4.25延时交易确认、4.27延时交易确认退回
以上交易类型成功或失败后,通知商户系统结果。
报文格式:JSON
请求方式:POST
Content-Type: application/json;charset=utf-8
签名sign计算规则详见:JSON格式签名计算。
注意:标准接口通知报文节点后续会根据需求而做新增,切勿以固定格式解析报文,避免增加节点造成代码报错。
注意:商户接收到通知处理成功后需响应字符串“success”,其他响应翼码系统认为通知失败会继续通知。
注意:同样的通知可能会多次发送给商户系统,商户系统必须能够正确处理重复的通知。
注意:可空节点数据为空时,既可能返回null也可能返回空字符串,请解析时注意兼容。
请求报文
{
"isspid": "00060803",
"pos_seq": "split202312291014001",
"split_seq": "202312290239230005417",
"type": "a",
"trade_state": "s",
"error_desc": "",
"org_pos_seq": "",
"org_split_seq": "",
"split_detail": [
{
"amount": 2,
"trade_state": "s",
"mch_type": "a",
"merchant_id": "1000668",
"type": "a"
},
{
"amount": 2,
"trade_state": "s",
"mch_type": "a",
"merchant_id": "1000667",
"type": "a"
},
{
"amount": 84,
"trade_state": "s",
"mch_type": "b",
"seller_account": "6666000141287397",
"type": "b"
}
],
"sign": "9E2815497C9CBC3875A5CFA67A6A3111"
}
请求报文说明
标准接口会因业务升级需要而新增节点,请在解析请求报文时避免新增未知节点产生的程序出错!
节点名称 | 中文名称 | 类型 | 说明 | 是否必填 |
---|---|---|---|---|
sign | 签名 | String(32) | 计算签名方式请看2.1章节 | 必填 |
isspid | 商户号 | String(8) | 交易的翼码商户号 | 必填 |
pos_seq | 商户请求流水号 | String(32) | 请求延时交易确认/延时交易确认退回的流水号(pos_seq) 通过企账通控台分账的交易,通知中没有此节点 | 可空 |
split_seq | 分账流水号 | String(32) | 企账通系统的流水号 | 必填 |
type | 交易类型 | String(1) | a:延时分账 b:延时分账退回 | 必填 |
trade_state | 交易状态 | String(1) | s:成功 f:失败 z:部分成功 部分成功时,需要具体判断明细中的分账状态 | 必填 |
error_desc | 失败原因 | String(1) | 可空 | |
org_pos_seq | 原商户请求流水号 | String(32) | 被退回的延时交易确认的商户请求流水号 通过企账通控台分账的交易,通知中没有此节点 | 可空 |
org_split_seq | 原分账流水号 | String(32) | 被退回的延时分账流水在企账通系统的流水号 | 可空 |
split_detail | 分账明细 | JSONArray | 必填 |
split_detail 分账明细 (JSONArray)
JSON节点 | 类型 | 说明 | 是否必填 | 范例 |
---|---|---|---|---|
amount | Number | 金额(分) | 必填 | 2000 |
trade_state | String | 分账状态 s:成功 f:失败 | 必填 | s |
type | String | 分账类型 a:参与分账 b:收款账户自留 | 必填 | a |
mch_type | String | 接收方类型 a:分账商户 b:收款账户 | 必填 | a |
merchant_id | String | 分账接收方的分账商户号 当mch_type=a时必填 | 可选 | 10000000000001 |
seller_account | String | 分账接收方的收款账户编号 当mch_type=b时必填 | 可选 | 6666000116230109 |
标准接口会因业务升级需要而新增节点,请在解析请求报文时避免新增未知节点产生的程序出错!
返回报文
success
返回报文说明
固定字符串“success”表示接收处理成功,其他表示失败。