业务说明

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

交易请求报文

JSON:

  1. {
  2. "request_type": "barcode_cancel_request",
  3. "isspid": "39493002",
  4. "pos_id": "6666666666",
  5. "store_id": "6666666666",
  6. "pos_seq": "2018121400000012",
  7. "user_id": "user01",
  8. "system_id": "8888",
  9. "barcode_cancel_request": {
  10. "pay_type": "",
  11. "org_pos_seq": "2018121400000010"
  12. },
  13. "sign": "38C73CFED3B3C6E0ED18AF04E8D34D94"
  14. }

XML:

  1. <?xml version="1.0" encoding="GBK"?>
  2. <business_trans>
  3. <request_type>barcode_cancel_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. <barcode_cancel_request>
  11. <pay_type>502</pay_type>
  12. <org_pos_seq>1511300000001</org_pos_seq>
  13. </barcode_cancel_request>
  14. </business_trans>

交易请求报文说明

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

交易返回报文

JSON:

  1. {
  2. "response_type": "barcode_cancel_response",
  3. "isspid": "00026713",
  4. "pos_id": "6666666666",
  5. "pos_seq": "2018121400000012",
  6. "trans_time": "20181214152755",
  7. "sys_seq": "f135e20440ea261b",
  8. "pay_type": "502",
  9. "extend": "<![CDATA[]]>",
  10. "alipay_res_info": {
  11. "trade_no": "",
  12. "out_trade_no": "2018121400000010",
  13. "detail_error_code": "",
  14. "detail_error_desc": ""
  15. },
  16. "wxpay_res_info": {
  17. "out_trade_no": "2018121400000011",
  18. "app_id": "wx5acb63e448b4fc22",
  19. "mch_id": "1241109502",
  20. "detail_error_code": "",
  21. "detail_error_desc": ""
  22. },
  23. "wxapp_res_info": {
  24. "out_trade_no": "2018121400000011",
  25. "app_id": "wx5acb63e448b4fc22",
  26. "mch_id": "1241109502",
  27. "detail_error_code": "",
  28. "detail_error_desc": ""
  29. },
  30. "upay_res_info": {
  31. "trade_no": "",
  32. "out_trade_no": "2018121400000011"
  33. },
  34. "balpay_res_info": {
  35. "trade_no": "4200000196201812146252898537",
  36. "out_trade_no": "2018121400000002",
  37. "cancel_amount": 1,
  38. "gmt_cancel_pay": "20210205111441",
  39. "member_id": "1452",
  40. },
  41. "jfqpay_res_info": {
  42. "trade_no": "",
  43. "out_trade_no": "2018121400000011"
  44. },
  45. "result": {
  46. "id": "0000",
  47. "comment": "交易成功"
  48. },
  49. "sign": "F3417D5E9CEF3AE32110C7EFBF5AB400"
  50. }

XML:

  1. <?xml version="1.0" encoding="GBK"?>
  2. <business_trans>
  3. <response_type>barcode_cancel_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. <alipay_res_info>
  12. <trade_no>2014110721001004640000791910</trade_no>
  13. <out_trade_no>2014110721001004640000791910</out_trade_no>
  14. <detail_error_code></detail_error_code>
  15. <detail_error_desc></detail_error_desc>
  16. </alipay_res_info>
  17. <wxpay_res_info>
  18. <out_trade_no>2014110721001004640000791910</out_trade_no>
  19. <app_id>2014110721001004640000791910</app_id>
  20. <mch_id>2014110721001004640000791910</mch_id>
  21. <detail_error_code></detail_error_code>
  22. <detail_error_desc></detail_error_desc>
  23. </wxpay_res_info>
  24. <wxapp_res_info>
  25. <out_trade_no>2014110721001004640000791910</out_trade_no>
  26. <app_id>2014110721001004640000791910</app_id>
  27. <mch_id>2014110721001004640000791910</mch_id>
  28. <detail_error_code></detail_error_code>
  29. <detail_error_desc></detail_error_desc>
  30. </wxapp_res_info>
  31. <upay_res_info>
  32. <trade_no>2014110721001004640000791910</trade_no>
  33. <out_trade_no>2014110721001004640000791910</out_trade_no>
  34. </upay_res_info>
  35. <balpay_res_info>
  36. <trade_no>15415906</trade_no>
  37. <out_trade_no>1000000000511</out_trade_no>
  38. <cancel_amount>1</cancel_amount>
  39. <gmt_cancel_pay>20210205111441</gmt_cancel_pay>
  40. <member_id>1452</member_id>
  41. </balpay_res_info>
  42. <jfqpay_res_info>
  43. <trade_no>2014110721001004640000791910</trade_no>
  44. <out_trade_no>2014110721001004640000791910</out_trade_no>
  45. </jfqpay_res_info>
  46. <result>
  47. <id>0000</id>
  48. <comment>成功</comment>
  49. </result>
  50. </business_trans>

交易返回报文说明

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

节点名称中文名称类型说明是否必填
sign报文签名String(32)返回报文格式为JSON时必填
计算签名方式请看2.1章节
可选
response_type返回类型String(32)固定值:barcode_cancel_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格式
预留字段后续业务扩展使用
可空
result
->id
响应码String(4)0000:成功
其它代表失败,错误信息说明见“响应码解释”字段
必填
result
->comment
响应码解释String(64)响应码对应中文注解,用于显示提示必填
支付宝返回返回以下数据
alipay_res_info
->trade_no
支付宝订单号String(64)直连通道交易成功时候,必填可空
alipay_res_info
->out_trade_no
支付商户订单号String(64)直连通道交易成功时候,必填可空
alipay_res_info
->detail_error_code
支付详细错误码String(48)
alipay_res_info
->detail_error_desc
支付详细错误码说明String(64)
微信支付返回返回以下数据
wxpay_res_info
->out_trade_no
微信订单号String(64)直连通道交易成功时候,必填可空
wxpay_res_info
->detail_error_code
支付商户订单号String(48)直连通道交易成功时候,必填可空
wxpay_res_info
->detail_error_desc
支付详细错误码说明String(128)直连通道交易成功时候,必填可空
wxpay_res_info
->app_id
微信公众帐号String(32)直连通道交易成功时候,必填可空
wxpay_res_info
->mch_id
微信商户帐号String(32)直连通道交易成功时候,必填可空
微信小程序返回返回以下数据
wxapp_res_info
->out_trade_no
微信订单号String(64)直连通道交易成功时候,必填可空
wxapp_res_info
->detail_error_code
支付商户订单号String(48)直连通道交易成功时候,必填可空
wxapp_res_info
->detail_error_desc
支付详细错误码说明String(128)直连通道交易成功时候,必填可空
wxapp_res_info
->app_id
微信公众帐号String(32)直连通道交易成功时候,必填可空
wxapp_res_info
->mch_id
微信商户帐号String(32)直连通道交易成功时候,必填可空
银联二维码返回返回以下数据
upay_res_info
->trade_no
银联订单号String(64)直连通道交易成功时候,必填可空
upay_res_info
->out_trade_no
支付商户订单号String(64)直连通道交易成功时候,必填可空
会员余额支付返回返回以下数据
balpay_res_info
->trade_no
支付平台订单号String(64)可空
balpay_res_info
->out_trade_no
支付商户订单号String(64)可空
balpay_res_info
->cancel_amount
撤销金额String(9)单位为分可空
balpay_res_info
->gmt_cancel_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)可空

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