交易请求报文

  1. <?xml version="1.0" encoding="GBK" ?>
  2. <business_trans>
  3. <request_type>card_query_request</request_type>
  4. <isspid>39493002</isspid>
  5. <pos_id>1511300001</pos_id>
  6. <store_id>1511300001</store_id>
  7. <pos_seq>1511300000001</pos_seq>
  8. <user_id>user01</user_id>
  9. <system_id>8888</system_id>
  10. <card_query_request>
  11. <valid_info>1234567890123456</valid_info>
  12. <encode_type>099</encode_type>
  13. </card_query_request>
  14. </business_trans>

交易请求报文说明

节点名称中文名称类型说明是否
必填
request_type请求类型String(32)标识请求报文的类型,固定为card_query_request必填
isspid商户号String(8)接入SP的ID号,为翼码凭证平台的提供的业务商机构号必填
pos_id终端号String(20)终端号(对方自定义的终端号)必填
store_id门店号String(20)门店号必填
pos_seq终端流水号String(32)同一个商户必须唯一,且大于12位必填
user_id操作员标识String(20)终端操作员号,对应于外部POS终端的操作员编号可选
system_id系统平台号String(4)由翼码提供必填
card_query_request->valid_info验证数据String(256)辅助码为明文(12或16位数字);
二维码为条码内容
必填
card_query_request->encode_type验证数据类型String(3)099-辅助码
098-二维码
(已支持不传该节点自动判断)
可选

交易返回报文

  1. <?xml version="1.0" encoding="GBK"?>
  2. <business_trans>
  3. <response_type>card_query_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. <query_info>
  10. <order_id>123456789</order_id>
  11. <batch_no>123456789</batch_no>
  12. <batch_name>测试活动</batch_name>
  13. <batch_short_name>测试活动</batch_short_name>
  14. <use_type>1</use_type>
  15. <va_status>2</va_status>
  16. <end_use_time>20170316235959</end_use_time>
  17. <remain_amt>1000</remain_amt>
  18. <remain_times>10</remain_times>
  19. <price>2000</price>
  20. </query_info>
  21. <verify_info>
  22. <count>2</count>
  23. <redeem>
  24. <store_id>6666666666</store_id>
  25. <pos_id>0001034843</pos_id>
  26. <pos_seq>1607080000015</pos_seq>
  27. <store_name>独立支付测试IPOS</store_name>
  28. <trans_time>20160708162255</trans_time>
  29. </redeem>
  30. <redeem>
  31. <store_id>6666666666</store_id>
  32. <pos_id>0001034843</pos_id>
  33. <pos_seq>1607080000015</pos_seq>
  34. <store_name>独立支付测试IPOS</store_name>
  35. <trans_time>20160708162255</trans_time>
  36. </redeem>
  37. </verify_info>
  38. <result>
  39. <id>0000</id>
  40. <comment>成功</comment>
  41. </result>
  42. </business_trans>

交易返回报文说明

节点名称中文名称类型说明是否
必填
response_type返回类型String(32)标识返回报文的类型,固定为card_query_response必填
isspid商户号String(8)接入SP的ID号,由翼码凭证通支撑平台分配给ipos接入受理商户的机构号必填
pos_id终端号String(20)终端号必填
pos_seq终端流水号String(32)终端交易流水号和请求报文的交易流水相同必填
sys_seq平台流水号String(22)由条码支撑平台产生,供跟踪之用必填
trans_time交易时间String(14)交易时间,格式:yyyymmddhh24miss必填
query_info->order_id订单号,业务商传入String(32)订单号,业务商传入必填
query_info->batch_no活动号String(11)活动号必填
query_info->batch_name活动名称String(128)活动名称必填
query_info->batch_short_name活动简称String(128)活动简称必填
query_info->use_type活动类型Number(1)0:金额型验证
1:次数型验证
必填
query_info->va_status验证状态Number(1)0:正常
1:撤消
2:使用中
3:已使用
必填
query_info->end_use_time条码有效期Number(14)条码结束使用时间必填
query_info->remain_amt可用金额Number可用金额,单位:分金额型时必填
query_info->remain_times可用次数Number(10)可用次数次数型时必填
query_info->price卡券面值Number卡券面值,单位:分次数型时必填
result->id响应码String(4)条码支撑平台返回的处理结果,0000-成功,其它失败,错误信息说明见“响应码解释”字段必填
result->comment响应码解释String(64)响应码对应中文注解,用于显示提示必填
验证状态为已使用或使用中时 返回以下条码验证信息
verify_info->count验证信息条数Number该条码已验证信息的条数必填
verify_info->redeem->store_id验证门店号String(10)外部门店号必填
verify_info->redeem->pos_id验证终端号String(10)外部终端号必填
verify_info->redeem->pos_seq验证终端流水号String(10)外部终端流水号必填
verify_info->redeem->store_name验证门店名称String(24)门店名称必填
verify_info->redeem->trans_time验证时间String(14)验证时间必填