业务说明

支持的交易类型:
4.2条码支付、4.3扫码支付、4.13jsapi支付、4.14微信小程序支付、4.21聚合动态码支付、4.22小程序支付收银台下单

交易请求报文

JSON:

  1. {
  2. "request_type": "barcode_refundquery_request",
  3. "isspid": "39493002",
  4. "pos_id": "8888888888",
  5. "store_id": "8888888888",
  6. "pos_seq": "2018121400000008",
  7. "user_id": "user01",
  8. "system_id": "8888",
  9. "barcode_refundquery_request": {
  10. "pay_type": "502",
  11. "org_pos_seq": "2018121400000006"
  12. },
  13. "sign": "A95561E9CBB30BD049000FD9C530B1AF"
  14. }

XML:

  1. <?xml version="1.0" encoding="GBK"?>
  2. <business_trans>
  3. <request_type>barcode_refundquery_request</request_type>
  4. <isspid>39493002</isspid>
  5. <pos_id>1511300001</pos_id>
  6. <store_id>1511300001</store_id>
  7. <pos_seq>1511300000003</pos_seq>
  8. <user_id>user01</user_id>
  9. <system_id>8888</system_id>
  10. <barcode_refundquery_request>
  11. <pay_type>502</pay_type>
  12. <org_pos_seq>1511300000001</org_pos_seq>
  13. </barcode_refundquery_request>
  14. </business_trans>

交易请求报文说明

节点名称中文名称类型说明是否必填
sign报文签名String(32)请求报文格式为JSON时必填
计算签名方式请看2.1章节
可选
request_type请求类型String(32)固定值:barcode_refundquery_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)由翼码提供必填
barcode_refundquery_request
->pay_type
支付类型String(3)502:支付宝
503:微信支付
512:银联二维码
515:微信小程序
516:数字人民币
519:会员余额支付
521:聚分期
可空
barcode_refundquery_request
->org_pos_seq
退款请求流水号String(32)被查询的退款请求流水号,且大于12位必填

交易返回报文

JSON:

  1. {
  2. "response_type": "barcode_refundquery_response",
  3. "isspid": "39493002",
  4. "pos_id": "8888888888",
  5. "pos_seq": "2018121400000008",
  6. "trans_time": "20181214151418",
  7. "sys_seq": "a4507a682d26403a",
  8. "pay_type": "502",
  9. "extend": "<![CDATA[]]>",
  10. "buss_discount_amt": 0,
  11. "platform_discount_amt": 0,
  12. "memo": "订单备注",
  13. "alipay_res_info": {
  14. "trade_no": "2018121422001429700548119225",
  15. "out_trade_no": "2018121400000001",
  16. "atu_trade_no": "2018121422001429700548119225",
  17. "atu_out_trade_no": "0001056562600000122014",
  18. "atu_out_refund_no": "2018121400000006",
  19. "detail_error_code": "",
  20. "detail_error_desc": "",
  21. "send_back_fee": "",
  22. "charge_amount": "0",
  23. "fee_allowance_info": "{\"receivable_fee_amt\":\"2\",\"actual_fee_amt\":\"1\",\"allowance_fee_amt\":\"1\"}",
  24. "gmt_refund_pay": ""
  25. },
  26. "wxpay_res_info": {
  27. "trade_no": "4200000196201812146252898537",
  28. "out_trade_no": "2018121400000002",
  29. "atu_trade_no": "2018121422001429700548119225",
  30. "atu_out_trade_no": "0001056562600000122014",
  31. "atu_out_refund_no": "2018121400000006",
  32. "app_id": "wx5acb63e448b4fc22",
  33. "mch_id": "1241109502",
  34. "detail_error_code": "",
  35. "detail_error_desc": "",
  36. "send_back_fee": "1",
  37. "settlement_total_fee": "",
  38. "settlement_refund_fee": "",
  39. "charge_amount": "0",
  40. "fee_allowance_info": "{\"receivable_fee_amt\":\"2\",\"actual_fee_amt\":\"1\",\"allowance_fee_amt\":\"1\"}",
  41. "gmt_refund_pay": "20181214150715"
  42. },
  43. "wxapp_res_info": {
  44. "trade_no": "4200000196201812146252898537",
  45. "out_trade_no": "2018121400000002",
  46. "atu_trade_no": "2018121422001429700548119225",
  47. "atu_out_trade_no": "0001056562600000122014",
  48. "atu_out_refund_no": "2018121400000006",
  49. "app_id": "wx5acb63e448b4fc22",
  50. "mch_id": "1241109502",
  51. "detail_error_code": "",
  52. "detail_error_desc": "",
  53. "send_back_fee": "1",
  54. "settlement_total_fee": "",
  55. "settlement_refund_fee": "",
  56. "charge_amount": "0",
  57. "fee_allowance_info": "{\"receivable_fee_amt\":\"2\",\"actual_fee_amt\":\"1\",\"allowance_fee_amt\":\"1\"}",
  58. "gmt_refund_pay": "20181214150715"
  59. },
  60. "upay_res_info": {
  61. "trade_no": "4200000196201812146252898537",
  62. "out_trade_no": "2018121400000002",
  63. "atu_trade_no": "2018121422001429700548119225",
  64. "atu_out_trade_no": "0001056562600000122014",
  65. "atu_out_refund_no": "2018121400000006",
  66. "refund_amt": "1",
  67. "charge_amount": "0",
  68. "fee_allowance_info": "{\"receivable_fee_amt\":\"2\",\"actual_fee_amt\":\"1\",\"allowance_fee_amt\":\"1\"}"
  69. },
  70. "ecny_res_info": {
  71. "trade_no": "4200000196201812146252898537",
  72. "out_trade_no": "2018121400000002",
  73. "refund_amount": "1",
  74. "do_refund_amount": "1",
  75. "charge_amount": "0",
  76. "gmt_refund_pay": "20210205113225",
  77. "order_status": "03",
  78. "detail_error_code": "",
  79. "detail_error_desc": ""
  80. },
  81. "balpay_res_info": {
  82. "trade_no": "4200000196201812146252898537",
  83. "out_trade_no": "2018121400000002",
  84. "refund_amount": "1",
  85. "charge_amount": "0",
  86. "gmt_refund_pay": "20210205111441",
  87. "member_id": "1452",
  88. },
  89. "jfqpay_res_info": {
  90. "trade_no": "4200000196201812146252898537",
  91. "out_trade_no": "2018121400000002",
  92. "refund_amount": "1",
  93. "charge_amount": "0",
  94. "gmt_refund_pay": "20210205111441",
  95. },
  96. "result": {
  97. "id": "0000",
  98. "comment": "交易成功"
  99. },
  100. "sign": "B94B9113A279C761A831C5B592E0BF09"
  101. }

XML:

  1. <?xml version="1.0" encoding="GBK"?>
  2. <business_trans>
  3. <response_type>barcode_refundquery_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>502</pay_type>
  10. <extend><![CDATA[扩展字段(json格式)]]></extend>
  11. <buss_discount_amt>2</buss_discount_amt>
  12. <platform_discount_amt>2</platform_discount_amt>
  13. <memo>订单备注</memo>
  14. <alipay_res_info>
  15. <trade_no></trade_no>
  16. <out_trade_no></out_trade_no>
  17. <atu_trade_no>2018111522001429701012895360</atu_trade_no>
  18. <atu_out_trade_no>1811150000001</atu_out_trade_no>
  19. <atu_out_refund_no>2018121400000006</atu_out_refund_no>
  20. <detail_error_code></detail_error_code>
  21. <detail_error_desc></detail_error_desc>
  22. <send_back_fee>1</send_back_fee>
  23. <charge_amount>0</charge_amount>
  24. <fee_allowance_info>[{手续费补贴返还信息(JOSN)}]</fee_allowance_info>
  25. <gmt_refund_pay>20181115092624</gmt_refund_pay>
  26. </alipay_res_info>
  27. <wxpay_res_info>
  28. <trade_no>4001172001201611169902101944</trade_no>
  29. <out_trade_no>0001034843100000087203</out_trade_no>
  30. <atu_trade_no>2018111522001429701012895360</atu_trade_no>
  31. <atu_out_trade_no>1811150000001</atu_out_trade_no>
  32. <atu_out_refund_no>2018121400000006</atu_out_refund_no>
  33. <app_id>wx5acb63e448b4fc22</app_id>
  34. <mch_id>1241109502</mch_id>
  35. <detail_error_code>SUCCESS</detail_error_code>
  36. <detail_error_desc>OK</detail_error_desc>
  37. <send_back_fee>1</send_back_fee>
  38. <settlement_total_fee>1</settlement_total_fee>
  39. <settlement_refund_fee>1</settlement_refund_fee>
  40. <charge_amount>0</charge_amount>
  41. <fee_allowance_info>[{手续费补贴返还信息(JOSN)}]</fee_allowance_info>
  42. <gmt_refund_pay>20181115092624</gmt_refund_pay>
  43. </wxpay_res_info>
  44. <wxapp_res_info>
  45. <trade_no>4001172001201611169902101944</trade_no>
  46. <out_trade_no>0001034843100000087203</out_trade_no>
  47. <atu_trade_no>2018111522001429701012895360</atu_trade_no>
  48. <atu_out_trade_no>1811150000001</atu_out_trade_no>
  49. <atu_out_refund_no>2018121400000006</atu_out_refund_no>
  50. <app_id>wx5acb63e448b4fc22</app_id>
  51. <mch_id>1241109502</mch_id>
  52. <detail_error_code>SUCCESS</detail_error_code>
  53. <detail_error_desc>OK</detail_error_desc>
  54. <send_back_fee>1</send_back_fee>
  55. <settlement_total_fee>1</settlement_total_fee>
  56. <settlement_refund_fee>1</settlement_refund_fee>
  57. <charge_amount>0</charge_amount>
  58. <fee_allowance_info>[{手续费补贴返还信息(JOSN)}]</fee_allowance_info>
  59. <gmt_refund_pay>20181115092624</gmt_refund_pay>
  60. </wxapp_res_info>
  61. <upay_res_info>
  62. <trade_no>4001172001201611169902101944</trade_no>
  63. <out_trade_no>0001034843100000087203</out_trade_no>
  64. <atu_trade_no>2018111522001429701012895360</atu_trade_no>
  65. <atu_out_trade_no>1811150000001</atu_out_trade_no>
  66. <atu_out_refund_no>2018121400000006</atu_out_refund_no>
  67. <refund_amt>1</refund_amt>
  68. <charge_amount>0</charge_amount>
  69. <fee_allowance_info>[{手续费补贴返还信息(JOSN)}]</fee_allowance_info>
  70. </upay_res_info>
  71. <ecny_res_info>
  72. <trade_no>4001172001201611169902101944</trade_no>
  73. <out_trade_no>0001034843100000087203</out_trade_no>
  74. <refund_amount>1</refund_amount>
  75. <do_refund_amount>1</do_refund_amount>
  76. <charge_amount>0</charge_amount>
  77. <gmt_refund_pay>20210205113225</gmt_refund_pay>
  78. <order_status>03</order_status>
  79. <detail_error_code></detail_error_code>
  80. <detail_error_desc></detail_error_desc>
  81. </ecny_res_info>
  82. <balpay_res_info>
  83. <trade_no>15415906</trade_no>
  84. <out_trade_no>1000000000511</out_trade_no>
  85. <refund_amount>1</refund_amount>
  86. <charge_amount>0</charge_amount>
  87. <gmt_refund_pay>20210205111441</gmt_refund_pay>
  88. <member_id>1452</member_id>
  89. </balpay_res_info>
  90. <jfqpay_res_info>
  91. <trade_no>15415906</trade_no>
  92. <out_trade_no>1000000000511</out_trade_no>
  93. <refund_amount>1</refund_amount>
  94. <charge_amount>0</charge_amount>
  95. <gmt_refund_pay>20210205111441</gmt_refund_pay>
  96. </jfqpay_res_info>
  97. <result>
  98. <id>0000</id>
  99. <comment>成功</comment>
  100. </result>
  101. </business_trans>

交易返回报文说明

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

节点名称中文名称类型说明是否必填
sign报文签名String(32)返回报文格式为JSON时必填
计算签名方式请看2.1章节
可选
response_type返回类型String(32)固定值:barcode_refundquery_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)502:支付宝
503:微信支付
512:银联二维码
515:微信小程序
516:数字人民币
519:会员余额支付
521:聚分期
必填
extend扩展信息String扩展信息字段内容为json格式
预留字段后续业务扩展使用
可空
buss_discount_amt商家优惠金额String(16)商家优惠金额,单位为分,支付宝类型根据返回平台结果可能返回为空值可空
platform_discount_amt平台优惠金额String(16)平台优惠金额,单位为分,支付宝类型根据返回平台结果可能返回为空值可空
memo订单备注String(128)返回退款请求时内容可空
result
->id
响应码String(4)0000:成功
9998:退款处理中,需要调用退款查询交易确认退款结果
其它代表失败,错误信息说明见“响应码解释”字段
必填
result
->comment
响应码解释String(64)响应码对应中文注解,用于显示提示必填
支付宝返回以下数据
alipay_res_info
->trade_no
支付宝订单号String(64)直连通道交易成功时候,必填可空
alipay_res_info
->out_trade_no
支付商户订单号String(64)直连通道交易成功时候,必填可空
alipay_res_info
->atu_trade_no
ATU订单号String(64)支付宝/微信/银联订单号
客户手机支付凭证上的订单号
可空
alipay_res_info
->atu_out_trade_no
ATU商户订单号String(64)支付宝/微信/银联商户订单号
客户手机支付凭证上的商户订单号
可空
alipay_res_info
->atu_out_refund_no
ATU退款商户订单号String(64)退款单的支付宝/微信/银联商户订单号可空
alipay_res_info
->detail_error_code
支付详细错误码String(48)可空
alipay_res_info
->detail_error_desc
支付详细错误码说明String(64)可空
alipay_res_info
->send_back_fee
卖家退款金额String(16)本次商户实际退回金额
即退款总金额减去商户优惠退款部分
默认不返回该信息,需与支付宝约定后配置返回,单位为分
可空
alipay_res_info
->charge_amount
退款手续费String(9)单位为分,交易成功时必填可空
alipay_res_info
->fee_allowance_info
手续费补贴返还信息StringJSONString格式,仅支持汇付通道交易
详细参数见下表
可空
alipay_res_info
->gmt_refund_pay
退款完成时间String(14)退款完成时间可空
微信支付返回以下数据
wxpay_res_info
->trade_no
微信订单号String(64)直连通道交易成功时候,必填可空
wxpay_res_info
->out_trade_no
支付商户订单号String(64)直连通道交易成功时候,必填可空
wxpay_res_info
->atu_trade_no
ATU订单号String(64)支付宝/微信/银联订单号
客户手机支付凭证上的订单号
可空
wxpay_res_info
->atu_out_trade_no
ATU商户订单号String(64)支付宝/微信/银联商户订单号
客户手机支付凭证上的商户订单号
可空
wxpay_res_info
->atu_out_refund_no
ATU退款商户订单号String(64)退款单的支付宝/微信/银联商户订单号可空
wxpay_res_info
->app_id
服务商公众号IDString(32)直连通道交易成功时候,必填可空
wxpay_res_info
->mch_id
服务商商户号String(32)直连通道交易成功时候,必填可空
wxpay_res_info
->detail_error_code
退款详细错误码String(48)直连通道交易成功时候,必填可空
wxpay_res_info
->detail_error_desc
退款详细错误码说明String(128)直连通道交易成功时候,必填可空
wxpay_res_info
->send_back_fee
卖家退款金额String(16)本次商户实际退回金额
即退款总金额减去商户优惠退款部分
直连通道交易成功时候,必填,单位为分
可空
wxpay_res_info
->settlement_total_fee
应结订单金额String(16)单位为分
当订单使用了免充值型优惠券后返回该参数,应结订单金额=订单金额-免充值优惠券金额。
可空
wxpay_res_info
->settlement_refund_fee
应结退款金额String(16)单位为分
去掉非充值代金券退款金额后的应结退款金额,应结退款金额=申请退款金额-非充值代金券退款金额,应结退款金额<=申请退款金额
可空
wxpay_res_info
->charge_amount
退款手续费String(9)单位为分,交易成功时必填可空
wxpay_res_info
->fee_allowance_info
手续费补贴返还信息StringJSONString格式,仅支持汇付通道交易
详细参数见下表
可空
wxpay_res_info
->gmt_refund_pay
退款完成时间String(14)退款完成时间可空
微信小程序支付返回以下数据
wxapp_res_info
->trade_no
微信订单号String(64)直连通道交易成功时候,必填可空
wxapp_res_info
->out_trade_no
支付商户订单号String(64)直连通道交易成功时候,必填可空
wxapp_res_info
->atu_trade_no
ATU订单号String(64)支付宝/微信/银联订单号
客户手机支付凭证上的订单号
可空
wxapp_res_info
->atu_out_trade_no
ATU商户订单号String(64)支付宝/微信/银联商户订单号
客户手机支付凭证上的商户订单号
可空
wxapp_res_info
->atu_out_refund_no
ATU退款商户订单号String(64)退款单的支付宝/微信/银联商户订单号可空
wxapp_res_info
->app_id
服务商公众号IDString(32)直连通道交易成功时候,必填可空
wxapp_res_info
->mch_id
服务商商户号String(32)直连通道交易成功时候,必填可空
wxapp_res_info
->detail_error_code
退款详细错误码String(48)直连通道交易成功时候,必填可空
wxapp_res_info
->detail_error_desc
退款详细错误码说明String(128)直连通道交易成功时候,必填可空
wxapp_res_info
->send_back_fee
卖家退款金额String(16)本次商户实际退回金额
即退款总金额减去商户优惠退款部分
直连通道交易成功时候,必填,单位为分
可空
wxapp_res_info
->settlement_total_fee
应结订单金额String(16)单位为分
当订单使用了免充值型优惠券后返回该参数,应结订单金额=订单金额-免充值优惠券金额。
可空
wxapp_res_info
->settlement_refund_fee
应结退款金额String(16)单位为分
去掉非充值代金券退款金额后的应结退款金额,应结退款金额=申请退款金额-非充值代金券退款金额,应结退款金额<=申请退款金额
可空
wxapp_res_info
->charge_amount
退款手续费String(9)单位为分,交易成功时必填可空
wxapp_res_info
->fee_allowance_info
手续费补贴返还信息StringJSONString格式,仅支持汇付通道交易
详细参数见下表
可空
wxapp_res_info
->gmt_refund_pay
退款完成时间String(14)退款完成时间可空
银联二维码返回以下数据
upay_res_info
->trade_no
银联订单号String(64)直连通道交易成功时候,必填可空
upay_res_info
->out_trade_no
支付商户订单号String(64)直连通道交易成功时候,必填可空
upay_res_info
->atu_trade_no
ATU订单号String(64)支付宝/微信/银联订单号
客户手机支付凭证上的订单号
可空
upay_res_info
->atu_out_trade_no
ATU商户订单号String(64)支付宝/微信/银联商户订单号
客户手机支付凭证上的商户订单号
可空
upay_res_info
->atu_out_refund_no
ATU退款商户订单号String(64)退款单的支付宝/微信/银联商户订单号可空
upay_res_info
->refund_amt
退款金额String(9)单位为分
标准银联/合利宝/星POS通道,交易成功时候,必填
可空
upay_res_info
->charge_amount
退款手续费String(9)单位为分,交易成功时必填可空
upay_res_info
->fee_allowance_info
手续费补贴返还信息StringJSONString格式,仅支持汇付通道交易
详细参数见下表
可空
数字人民币返回以下数据
ecny_res_info
->trade_no
平台订单号String(64)直连通道交易成功时候,必填可空
ecny_res_info
->out_trade_no
支付商户订单号String(64)直连通道交易成功时候,必填可空
ecny_res_info
->refund_amount
退款金额String(64)直连通道交易成功时候,必填可空
ecny_res_info
->do_refund_amt
订单已退金额String(64)直连通道交易成功时候,必填可空
ecny_res_info
->charge_amount
退款手续费String(9)单位为分,交易成功时必填可空
ecny_res_info
->gmt_refund_pay
退款订单的交易时间String(64)直连通道交易成功时候,必填可空
ecny_res_info
->order_status
原始订单的状态String(64)01:订单创建,02:用户支付中,03:已关闭,04:部分退款,05:全部退款,06:交易成功可空
ecny_res_info
->detail_error_code
通道原始应答码,直连通道交易成功时候String(64)直连通道交易失败时候可空
ecny_res_info
->detail_error_desc
通道原始应答说明,直连通道交易成功时候String(64)直连通道交易失败时候可空
会员余额支付返回以下数据
balpay_res_info
->trade_no
支付平台订单号String(64)可空
balpay_res_info
->out_trade_no
支付商户订单号String(64)可空
balpay_res_info
->refund_amount
退款金额String(9)单位为分可空
balpay_res_info
->charge_amount
退款手续费String(9)单位为分,交易成功时必填可空
balpay_res_info
->gmt_refund_pay
退款完成时间String(14)格式:yyyyMMddHHmmss可空
balpay_res_info
->member_id
会员idString(9)可空
聚分期返回以下数据
jfqpay_res_info
->trade_no
支付平台订单号String(64)可空
jfqpay_res_info
->out_trade_no
支付商户订单号String(64)可空
jfqpay_res_info
->refund_amount
退款金额String(9)单位为分可空
jfqpay_res_info
->charge_amount
退款手续费String(9)单位为分,交易成功时必填可空
jfqpay_res_info
->gmt_refund_pay
退款完成时间String(14)格式:yyyyMMddHHmmss可空

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

fee_allowance_info 手续费补贴返还信息 (JSONString)

JSON节点类型说明是否必填范例
receivable_ref_fee_amtString退款返还总手续费,单位:分必填2
actual_ref_fee_amtString退款返还商户手续费,单位:分必填1
allowance_ref_fee_amtString退款返还补贴手续费,单位:分必填1