业务说明

支持的交易类型:4.34网银支付、4.65快捷支付申请、4.67快捷支付页面版

交易请求报文

JSON:

  1. {
  2. "request_type": "online_refund_request",
  3. "isspid": "39493002",
  4. "pos_id": "8888888888",
  5. "store_id": "8888888888",
  6. "pos_seq": "2018121400000006",
  7. "user_id": "user01",
  8. "system_id": "8888",
  9. "device_type": "4",
  10. "device_ip": "127.0.0.1",
  11. "memo": "订单备注",
  12. "online_refund_request": {
  13. "tx_amt": "1",
  14. "org_pos_seq": "2018121400000001",
  15. "extend_params": {
  16. "split_info": {
  17. "keep_amt": "800",
  18. "split_list": [
  19. {
  20. "merchant_id": "10000000000001",
  21. "div_amt": "150"
  22. },
  23. {
  24. "merchant_id": "10000000000002",
  25. "div_amt": "50"
  26. }
  27. ]
  28. }
  29. }
  30. },
  31. "sign": "E622B688C360F8444788740B111E4787"
  32. }

XML:

  1. <?xml version="1.0" encoding="GBK"?>
  2. <business_trans>
  3. <request_type>online_refund_request</request_type>
  4. <isspid>39493002</isspid>
  5. <pos_id>1511300001</pos_id>
  6. <store_id>1511300001</store_id>
  7. <pos_seq>1511300000004</pos_seq>
  8. <user_id>user01</user_id>
  9. <system_id>8888</system_id>
  10. <device_type>4</device_type>
  11. <device_ip>127.0.0.1</device_ip>
  12. <memo>订单备注</memo>
  13. <online_refund_request>
  14. <tx_amt>10</tx_amt>
  15. <org_pos_seq>1511300000001</org_pos_seq>
  16. <extend_params><![CDATA[扩展参数(JSONObject)]]></extend_params>
  17. </online_refund_request>
  18. </business_trans>

交易请求报文说明

节点名称中文名称类型说明是否必填
sign报文签名String(32)请求报文格式为JSON时必填
计算签名方式请看2.1章节
可选
request_type请求类型String(32)固定值:online_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)由翼码提供必填
device_type设备类型String(1)1:手机
2:平板
3:手表
4:PC
发起交易设备的类型
必填
device_ip设备IPString(15)发起交易设备的公网IP必填
memo订单备注String(128)可空
online_refund_request
->tx_amt
退款金额Number(9)单位为分必填
online_refund_request
->org_pos_seq
支付请求流水号String(32)被退款的支付请求流水号,且大于12位必填
online_refund_request
->extend_params
扩展参数JSONObject用于扩展一些特殊的支付参数字段,详细参数见下表
使用XML格式报文时,建议使用CDATA标签包裹内容
可空

extend_params 扩展参数

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

split_info 分账信息

JSON节点类型说明是否必填范例
keep_amtString从分账方自留金额中退款的金额,单位为分,可传0表示不从自留中退必填1000
split_listJSONArray分账明细可空 
split_list 分账明细
JSON节点类型说明是否必填范例
merchant_idString分账接收方的分账商户号必填10000000000001
div_amtString从分账金额中退款的金额,单位为分,必须大于0必填1000

extend_params 样例:

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

交易返回报文

JSON:

  1. {
  2. "response_type": "online_refund_response",
  3. "system_id": "8888",
  4. "isspid": "39493002",
  5. "pos_id": "8888888888",
  6. "pos_seq": "2018121400000006",
  7. "trans_time": "20181214145332",
  8. "sys_seq": "b7ff9fa5bb4355e2",
  9. "pay_type": "517",
  10. "res_info": {
  11. "trade_no": "4200000196201812146252898537",
  12. "out_trade_no": "2018121400000002",
  13. "refund_amt": 1,
  14. "refund_time": "20221113203144"
  15. },
  16. "result": {
  17. "id": "0000",
  18. "comment": "退款成功"
  19. },
  20. "sign": "207482F2C0A998B73F388B8AA401DB76"
  21. }

XML:

  1. <?xml version="1.0" encoding="GBK"?>
  2. <business_trans>
  3. <response_type>online_refund_response</response_type>
  4. <isspid>39493002</isspid>
  5. <pos_id>123456789</pos_id>
  6. <pos_seq>000000000001</pos_seq>
  7. <sys_seq>000000000244</sys_seq>
  8. <trans_time>20090405010104</trans_time>
  9. <pay_type>517</pay_type>
  10. <res_info>
  11. <trade_no>15415906</trade_no>
  12. <out_trade_no>1000000000511</out_trade_no>
  13. <refund_amt>1</refund_amt>
  14. <refund_time>20221113203144</refund_time>
  15. </res_info>
  16. <result>
  17. <id>0000</id>
  18. <comment>退款成功</comment>
  19. </result>
  20. </business_trans>

交易返回报文说明

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

节点名称中文名称类型说明是否必填
sign报文签名String(32)返回报文格式为JSON时必填
计算签名方式请看2.1章节
可选
response_type返回类型String(32)固定值:online_refund_response必填
isspid商户号String(8)翼码商户号,由翼码提供必填
pos_id终端号String(20)商户自定义终端号必填
pos_seq退款请求流水号String(32)退款请求流水号,和请求报文相同必填
sys_seq随机串号String(16)随机生成串号,仅用于日志跟踪用,不保存必填
trans_time接口返回时间String(14)接口返回时间,格式:yyyyMMddHHmmss必填
pay_type支付类型String(3)517:网银支付
518:快捷支付
必填
res_info
->trade_no
通道支付流水号String(64)支付交易的通道唯一流水号可空
res_info
->out_trade_no
支付商户订单号String(32)支付交易的商户订单号可空
res_info
->refund_amt
退款金额String(9)单位为分可空
res_info
->refund_time
退款时间String(14)格式:yyyyMMddHHmmss可空
result
->id
响应码String(4)0000:退款成功
9998:退款处理中(需要调用退款查询确认退款结果)
其它为失败,错误信息说明见“响应码解释”字段
必填
result
->comment
响应码解释String(64)响应码对应中文注解,用于显示提示必填

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