交易请求报文

JSON:

  1. {
  2. "request_type": "barcode_queryorder_request",
  3. "isspid": "39493002",
  4. "pos_id": "8888888888",
  5. "store_id": "8888888888",
  6. "pos_seq": "2018121400000022",
  7. "user_id": "user01",
  8. "system_id": "8888",
  9. "barcode_queryorder_request": {
  10. "org_pos_seq": "2018121400000001"
  11. },
  12. "sign": "A7E60EACBAB7DD32A6FF4BC941234933"
  13. }

XML:

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

交易请求报文说明

节点名称中文名称类型说明是否必填
sign报文签名String(32)请求报文格式为JSON时必填
计算签名方式请看2.1章节
可选
request_type请求类型String(32)固定值:barcode_queryorder_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_queryorder_request
->org_pos_seq
支付请求流水号String(32)被查询的支付请求流水号,且大于12位必填

交易返回报文

JSON:

  1. {
  2. "response_type": "barcode_queryorder_response",
  3. "isspid": "39493002",
  4. "pos_id": "1511300001",
  5. "pos_seq": "1511300000010",
  6. "extend": "<![CDATA[]]>",
  7. "order_info": {
  8. "trans_type": "1",
  9. "trans_time": "20160823151010",
  10. "pos_seq": "1511300000006",
  11. "pay_type": "502",
  12. "status": "1",
  13. "tx_amt": 1000,
  14. "buss_discount_amt": 2,
  15. "platform_discount_amt": 2,
  16. "memo": "订单备注"
  17. },
  18. "reverse_list": [
  19. {
  20. "trans_type": "2",
  21. "trans_time": "20160823152010",
  22. "pos_seq": "1511300000007",
  23. "pay_type": "502",
  24. "status": "0",
  25. "tx_amt": 500,
  26. "org_pos_seq": "1511300000006"
  27. },
  28. {
  29. "trans_type": "2",
  30. "trans_time": "20160823153010",
  31. "pos_seq": "1511300000008",
  32. "pay_type": "502",
  33. "status": "0",
  34. "tx_amt": 500,
  35. "org_pos_seq": "1511300000006"
  36. }
  37. ],
  38. "result": {
  39. "id": "0000",
  40. "comment": "交易成功"
  41. },
  42. "sign": "FE1263A8A77F8DF257CE1755E4FD500E"
  43. }

XML:

  1. <?xml version="1.0" encoding="GBK"?>
  2. <business_trans>
  3. <response_type>barcode_queryorder_response</response_type>
  4. <isspid>39493002</isspid>
  5. <pos_id>1511300001</pos_id>
  6. <pos_seq>1511300000010</pos_seq>
  7. <extend><![CDATA[扩展字段(json格式)]]></extend>
  8. <order_info>
  9. <trans_type>1</trans_type>
  10. <trans_time>20160823151010</trans_time>
  11. <pos_seq>1511300000006</pos_seq>
  12. <pay_type>502</pay_type>
  13. <status>1</status>
  14. <tx_amt>1000</tx_amt>
  15. <buss_discount_amt>2</buss_discount_amt>
  16. <platform_discount_amt>2</platform_discount_amt>
  17. <memo>订单备注</memo>
  18. </order_info>
  19. <reverse_list>
  20. <reverse_row>
  21. <trans_type>2</trans_type>
  22. <trans_time>20160823152010</trans_time>
  23. <pos_seq>1511300000007</pos_seq>
  24. <pay_type>502</pay_type>
  25. <status>0</status>
  26. <tx_amt>500</tx_amt>
  27. <org_pos_seq>1511300000006</org_pos_seq>
  28. </reverse_row>
  29. <reverse_row>
  30. <trans_type>2</trans_type>
  31. <trans_time>20160823153010</trans_time>
  32. <pos_seq>1511300000008</pos_seq>
  33. <pay_type>502</pay_type>
  34. <status>0</status>
  35. <tx_amt>500</tx_amt>
  36. <org_pos_seq>1511300000006</org_pos_seq>
  37. </reverse_row>
  38. </reverse_list>
  39. <result>
  40. <id>0000</id>
  41. <comment>交易成功</comment>
  42. </result>
  43. </business_trans>

交易返回报文说明

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

节点名称中文名称类型说明是否必填
sign报文签名String(32)返回报文格式为JSON时必填
计算签名方式请看2.1章节
可选
response_type返回类型String(32)固定值:barcode_queryorder_response必填
isspid商户号String(8)翼码商户号,由翼码提供必填
pos_id终端号String(20)商户自定义终端号必填
pos_seq查询请求流水号String(32)查询请求流水号,和请求报文相同可选
extend扩展信息String扩展信息字段内容为json格式
预留字段后续业务扩展使用
可空
result
->id
响应码String(4)翼码平台返回的处理结果,0000-成功,其它失败,错误信息说明见“响应码解释”字段必填
result
->comment
响应码解释String(64)响应码对应中文注解,用于显示提示必填
order_info
->trans_type
交易类型String(1)1:支付必填
order_info
->trans_time
交易时间String(14)交易时间,格式:yyyyMMddHHmmss必填
order_info
->pos_seq
支付请求流水号String(32)必填
order_info
->pay_type
支付类型String(3)502:支付宝
503:微信支付
515:微信小程序
512:银联二维码
516:数字人民币
517:网银支付
518:快捷支付
519:会员余额支付
521:聚分期
必填
order_info
->status
交易状态String(1)0:成功
6:等待付款
1:已退款 (仅支付交易类型)
a:部分退款 (仅支付交易类型)
8:未付款已撤销 (仅支付交易类型)
3:失败
必填
order_info
->tx_amt
交易金额String(16)交易金额,单位为分,不支持小数点必填
order_info
->buss_discount_amt
商家优惠金额String(16)商家优惠金额,单位为分可空
order_info
->platform_discount_amt
平台优惠金额String(16)平台优惠金额,单位为分可空
order_info
->memo
订单备注String(128)返回支付请求时内容可空
reverse_list退款流水列表若无退款信息节点为空
reverse_row每条流水子节点,JSON格式没有reverse_row节点,子节点直接并列组成reverse_list参考交易返回报文
trans_type交易类型String(1)2:退款必填
trans_time交易时间String(14)交易时间,格式:yyyyMMddHHmmss必填
pos_seq退款请求流水号String(32)必填
pay_type支付类型String(3)502:支付宝
503:微信支付
515:微信小程序
512:银联二维码
516:数字人民币
517:网银支付
518:快捷支付
519:会员余额支付
521:聚分期
必填
status交易状态String(1)0:成功
3:失败
6:退款处理中
必填
tx_amt交易金额String(16)交易金额,单位为分,不支持小数点必填
org_pos_seq支付请求流水号String(28)被退款的支付请求流水号可空

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