交易请求报文

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. "pos_sn": "xxxxxxxxxxxxx"
  13. },
  14. "sign": "A95561E9CBB30BD049000FD9C530B1AF"
  15. }

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. <pos_sn>xxxxxxxxxx</pos_sn>
  14. </barcode_refundquery_request>
  15. </business_trans>

交易请求报文说明

节点名称中文名称类型说明是否必填
sign报文签名String(32)请求报文格式为JSON时必填
计算签名方式请看2.1章节
可选
request_type请求类型String(32)标识请求报文的类型,固定为barcode_refundquery_request必填
isspid商户号String(8)接入SP的ID号,由翼码平台分配给ipos接入受理商户的机构号(原值返回)必填
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:小程序支付
可空
barcode_refundquery_request
->org_pos_seq
需要查询的退款交易流水号String(32)需要查询的退款交易流水号,且大于12位必填
barcode_refundquery_request
->pos_sn
设备sn号String设备sn号,设备上可查看必填

交易返回报文

JSON:

  1. {
  2. "response_type": "barcode_refundquery_response",
  3. "isspid": "39493002",
  4. "pos_id": "8888888888",
  5. "pos_seq": "2018121400000008",
  6. "sys_seq": "a4507a682d26403a",
  7. "trans_time" "20201130111111",
  8. "pay_type": "502",
  9. "extend": "<![CDATA[]]>",
  10. "result": {
  11. "id": "0000",
  12. "comment": "交易成功"
  13. },
  14. "pay_response": {
  15. "trans_amount": "10",
  16. "amount": "10",
  17. "trade_no": "xxxxxxxxxxx",
  18. "trans_time": "20201130111111"
  19. },
  20. "sign": "B94B9113A279C761A831C5B592E0BF09"
  21. }

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>20201130111111</trans_time>
  9. <pay_type>502</pay_type>
  10. <extend><![CDATA[扩展字段(json格式)]]></extend>
  11. <result>
  12. <id>0000</id>
  13. <comment>成功</comment>
  14. </result>
  15. <pay_response>
  16. <trans_amount>10</trans_amount>
  17. <amount>10</amount>
  18. <trade_no>xxxxxxxxx</trade_no>
  19. <total_fee>10</total_fee>
  20. <trans_time>20201130111111</trans_time>
  21. </pay_response>
  22. </business_trans>

交易返回报文说明

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

节点名称中文名称类型说明是否必填
sign报文签名String(32)返回报文格式为JSON时必填
计算签名方式请看2.1章节
可选
response_type返回类型String(32)标识返回报文的类型,固定为barcode_refundquery_response必填
isspid商户号String(8)接入SP的ID号,为翼码平台的提供的业务商机构号必填
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:小程序支付
必填
extend扩展信息String扩展信息字段内容为json格式
预留字段后续业务扩展使用
可空
result
->id
响应码String(4)翼码平台返回的处理结果
0000-成功
9998-退款处理中,需要调用退款查询交易确认退款结果
其它为失败,错误信息说明见“响应码解释”字段
必填
result
->comment
响应码解释String(64)响应码对应中文注解,用于显示提示必填
交易返回数据 pay_response仅result->id返回为0000时返回以下数据可空
pay_response
->trans_amount
实际退款金额Number(9)单位:分,不支持小数必填
pay_response
->amount
请求退款金额Number(9)单位:分,不支持小数必填
pay_response
->trade_no
系统交易流水String支付宝、微信、银联等返回的交易流水号必填
pay_response
->total_fee
交易订单金额Number(9)支付时的订单金额必填
pay_response
->trans_time
系统交易时间String(14)支付宝、微信等系统交易时间,格式:yyyyMMddHHmmss必填

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