业务说明

本接口请求方为翼码系统,接收方为商家系统。

支持的交易类型:
4.25延时交易确认、4.27延时交易确认退回

以上交易类型成功或失败后,通知商户系统结果。

报文格式:JSON

请求方式:POST

Content-Type: application/json;charset=utf-8

签名sign计算规则详见:JSON格式签名计算

注意:标准接口通知报文节点后续会根据需求而做新增,切勿以固定格式解析报文,避免增加节点造成代码报错。

注意:商户接收到通知处理成功后需响应字符串“success”,其他响应翼码系统认为通知失败会继续通知。

注意:同样的通知可能会多次发送给商户系统,商户系统必须能够正确处理重复的通知。

注意:可空节点数据为空时,既可能返回null也可能返回空字符串,请解析时注意兼容。

请求报文

  1. {
  2. "isspid": "00060803",
  3. "pos_seq": "split202312291014001",
  4. "split_seq": "202312290239230005417",
  5. "type": "a",
  6. "trade_state": "s",
  7. "error_desc": "",
  8. "org_pos_seq": "",
  9. "org_split_seq": "",
  10. "split_detail": [
  11. {
  12. "amount": 2,
  13. "trade_state": "s",
  14. "mch_type": "a",
  15. "merchant_id": "1000668",
  16. "type": "a"
  17. },
  18. {
  19. "amount": 2,
  20. "trade_state": "s",
  21. "mch_type": "a",
  22. "merchant_id": "1000667",
  23. "type": "a"
  24. },
  25. {
  26. "amount": 84,
  27. "trade_state": "s",
  28. "mch_type": "b",
  29. "seller_account": "6666000141287397",
  30. "type": "b"
  31. }
  32. ],
  33. "sign": "9E2815497C9CBC3875A5CFA67A6A3111"
  34. }

请求报文说明

标准接口会因业务升级需要而新增节点,请在解析请求报文时避免新增未知节点产生的程序出错!

节点名称中文名称类型说明是否必填
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节点类型说明是否必填范例
amountNumber金额(分)必填2000
trade_stateString分账状态
s:成功
f:失败
必填s
typeString分账类型
a:参与分账
b:收款账户自留
必填a
mch_typeString接收方类型
a:分账商户
b:收款账户
必填a
merchant_idString分账接收方的分账商户号
当mch_type=a时必填
可选10000000000001
seller_accountString分账接收方的收款账户编号
当mch_type=b时必填
可选6666000116230109

标准接口会因业务升级需要而新增节点,请在解析请求报文时避免新增未知节点产生的程序出错!

返回报文

success

返回报文说明

固定字符串“success”表示接收处理成功,其他表示失败。