交易请求报文

JSON:

  1. {
  2.     "request_type": "account_refund_request",
  3.     "isspid": "39493002",
  4.     "pos_id": "6666666666",
  5.     "store_id": "6666666666",
  6.     "pos_seq": "AR2018121400000004",
  7.     "user_id": "user01",
  8.     "system_id": "8888",
  9.     "memo": "订单备注",
  10.     "account_refund_request": {
  11.         "org_pos_seq": "AP2018121400000004",
  12.         "tx_amt": "150",
  13.         "extend_params": {
  14.             "split_info": {
  15.                 "split_list": [
  16.                     {
  17.                         "merchant_id": "10000000000001",
  18.                         "div_amt": "50"
  19.                     },
  20.                     {
  21.                         "seller_account": "6666000116230109",
  22.                         "div_amt": "150"
  23.                     }
  24.                 ]
  25.             }
  26.         }
  27.     },
  28.     "sign": "38C73CFED3B3C6E0ED18AF04E8D34D94"
  29. }

XML:

  1. <?xml version="1.0" encoding="GBK"?>
  2. <business_trans>
  3.     <request_type>account_refund_request</request_type>
  4.     <isspid>39493002</isspid>
  5.     <pos_id>6666666666</pos_id>
  6.     <store_id>6666666666</store_id>
  7.     <pos_seq>AR2018121400000004</pos_seq>
  8.     <user_id>user01</user_id>
  9.     <system_id>8888</system_id>
  10.     <memo>订单备注</memo>
  11.     <account_refund_request>
  12.         <org_pos_seq>AP2018121400000004</org_pos_seq>
  13.         <tx_amt>150</tx_amt>
  14.         <extend_params><![CDATA[
  15.         {
  16.             "split_info": {
  17.                 "split_list": [
  18.                     {
  19.                         "merchant_id": "10000000000001",
  20.                         "div_amt": "50"
  21.                     },
  22.                     {
  23.                         "seller_account": "6666000116230109",
  24.                         "div_amt": "150"
  25.                     }
  26.                 ]
  27.             }
  28.         }
  29.         ]]></extend_params>
  30.     </account_refund_request>
  31. </business_trans>

交易请求报文说明

节点名称中文名称类型说明是否必填
sign报文签名String(32)请求报文格式为JSON时必填
计算签名方式请看2.1章节		可选
request_type请求类型String(32)固定值：account_refund_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)可空
account_refund_request
->org_pos_seq		支付请求流水号String(32)被查询的支付请求流水号，且大于12位必填
account_refund_request
->tx_amt		退款总金额Number(9)单位为分必填
account_refund_request
->extend_params		扩展参数JSON用于扩展一些特殊的支付参数字段
若使用XML报文时请使用CDATA标签包裹内容
详细参数见下表		可空

extend_params 扩展参数 (JSON)

JSON节点类型说明是否必填范例
split_infoJSON分账信息
有实时分账的交易在部分退款时，若原支付订单使用净值分账则无需传分账信息，若原支付订单使用非净值分账，则退款必须传入分账信息，否则会报错。
部分支付通道不支持分账金额退回。		可空　

split_info 分账信息

JSON节点类型说明是否必填范例
split_listArray分账明细可空　
split_list 分账明细
JSON节点类型说明是否必填范例
merchant_idString分账接收方的分账商户号
分账商户号与收款账户编号二选一必填		可选10000000000001
seller_accountString分账接收方的收款账户编号
分账商户号与收款账户编号二选一必填		可选6666000116230109
div_amtString从分账金额中退款的金额，单位为分，必须大于0必填1000

extend_params 样例：

  1. {
  2.     "split_info": {
  3.         "split_list": [
  4.             {
  5.                 "merchant_id": "10000000000001",
  6.                 "div_amt": "50"
  7.             },
  8.             {
  9.                 "seller_account": "6666000116230109",
  10.                 "div_amt": "150"
  11.             }
  12.         ]
  13.     }
  14. }

交易返回报文

JSON:

  1. {
  2.     "response_type": "account_refund_response",
  3.     "isspid": "39493002",
  4.     "pos_id": "6666666666",
  5.     "pos_seq": "AR2018121400000004",
  6.     "trans_time": "20181214152755",
  7.     "sys_seq": "f135e20440ea261b",
  8.     "result": {
  9.         "id": "0000",
  10.         "comment": "交易成功"
  11.     },
  12.     "sign": "F3417D5E9CEF3AE32110C7EFBF5AB400"
  13. }

XML:

  1. <?xml version="1.0" encoding="GBK"?>
  2. <business_trans>
  3.     <response_type>account_refund_response</response_type>
  4.     <isspid>39493002</isspid>
  5.     <pos_id>6666666666</pos_id>
  6.     <pos_seq>AR2018121400000004</pos_seq>
  7.     <sys_seq>f135e20440ea261b</sys_seq>
  8.     <trans_time>20181214152755</trans_time>
  9.     <result>
  10.         <id>0000</id>
  11.         <comment>成功</comment>
  12.     </result>
  13. </business_trans>

交易返回报文说明

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

节点名称中文名称类型说明是否必填
sign报文签名String(32)返回报文格式为JSON时必填
计算签名方式请看2.1章节		可选
response_type返回类型String(32)固定值：account_refund_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)响应码对应中文注解，用于显示提示必填

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