交易请求报文

  1. <?xml version="1.0" encoding="GBK"?>
  2. <business_trans>
  3. <request_type>wecard_getcodeinfo_request</request_type>
  4. <isspid>39493002</isspid>
  5. <transaction_id>1511300000004</transaction_id>
  6. <system_id>8888</system_id>
  7. <code>1111111111</code>
  8. <encrypt_code></encrypt_code>
  9. </business_trans>

交易请求报文说明

节点名称中文名称类型说明是否必填
request_type请求类型String(32)标识请求报文的类型,固定为wecard_getcodeinfo_request必填
isspid商户号String(8)接入SP的ID号,由翼码平台分配给ipos接入受理商户的机构号(原值返回)必填
transaction_id请求流水号String不校验格式,建议随机唯一值方便快速查找日志可空
system_id系统平台号String(4)由翼码提供必填
code礼品卡codeString礼品卡code可空
encrypt_code微信加密后的codeString用于获取code使用可空

交易返回报文

  1. <?xml version="1.0" encoding="GBK"?>
  2. <business_trans>
  3. <response_type>wecard_getcodeinfo_response</response_type>
  4. <isspid>39493002</isspid>
  5. <transaction_id>190213000000000003</transaction_id>
  6. <extend></extend>
  7. <base_info>
  8. <brand_name>zy测试</brand_name>
  9. <logo_url><![CDATA[http://mmbiz.qpic.cn/mmbiz_jpg/S1bGasuAHyouYYgbjJJrTD9ZWZt8iaiacA6jicsbia9KxjGSYGprpx6Apu41PiaUeLtmdOBoONoqaxlOj6y5fZABbQg/0?src=https://hxn-coupon.wangcaio2o.com/upload/image/1006/2019/01/31/5b87ff07f1dcbdbcd9e7d9b8e0ba51d0.jpg]]></logo_url>
  10. <card_type>2</card_type>
  11. <title>张亚的礼品卡</title>
  12. <use_all_locations>1</use_all_locations>
  13. <location_id_list></location_id_list>
  14. <service_phone></service_phone>
  15. <cancel_type>3</cancel_type>
  16. <stock>6</stock>
  17. <time_type>DATE_TYPE_FIX_TIME_RANGE</time_type>
  18. <begin>1549814400</begin>
  19. <end>1550073599</end>
  20. </base_info>
  21. <trace_info>
  22. <node_id>1006</node_id>
  23. <order_id>AQAAYfBdcLRuhXBkBgWZ2Y6m3RKG</order_id>
  24. <card_id>pBZnZjo-nSrhYjUyOHPr4s4fDcvo</card_id>
  25. <user_card_code>2234100004129</user_card_code>
  26. <total_price>1</total_price>
  27. <overplus>1000</overplus>
  28. <use_flag>3</use_flag>
  29. <consume_source></consume_source>
  30. <location_name></location_name>
  31. <verify_time></verify_time>
  32. <req_seq></req_seq>
  33. <pos_id>00000000</pos_id>
  34. <store_id></store_id>
  35. </trace_info>
  36. <result>
  37. <id>0000</id>
  38. <comment>查询成功</comment>
  39. </result>
  40. </business_trans>

交易返回报文说明

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

节点名称中文名称类型说明是否必填
response_type返回类型String(32)标识返回报文的类型,固定为wecard_getcodeinfo_response必填
isspid商户号String(8)接入SP的ID号,为翼码平台的提供的业务商机构号必填
transaction_id请求流水号String与请求一致可空
extend扩展信息String扩展信息字段内容为json格式
预留字段后续业务扩展使用
可空
base_info
->brand_name
商家名称String可空
base_info
->logo_url
商户logoString用CDATA标签包裹可空
base_info
->card_type
礼品卡类型String2:单品
3:现金
可空
base_info
->title
礼品卡名称String可空
base_info
->use_all_locations
是否全门店String0:否
1:是
可空
base_info
->location_id_list
可使用门店IDString多门店ID以英文逗号“,”分隔可空
base_info
->service_phone
商户电话号码String可空
base_info
->cancel_type
核销方式String2:自助核销
3:为扫码核销
可空
base_info
->stock
商品库存String可空
base_info
->time_type
时间类型StringDATE_TYPE_FIX_TIME_RANGE:固定时长类型
DATE_TYPE_FIX_TERM:固定日期类型
可空
base_info
->begin
开始时间StringDATE_TYPE_FIX_TIME_RANGE类型返回秒级时间戳
DATE_TYPE_FIX_TERM类型返回天数
可空
base_info
->end
结束时间StringDATE_TYPE_FIX_TIME_RANGE类型返回秒级时间戳
DATE_TYPE_FIX_TERM类型返回天数
可空
trace_info
->node_id
商户唯一idString可空
trace_info
->order_id
订单idString可空
trace_info
->card_id
礼品卡idString可空
trace_info
->user_card_code
codeString可空
trace_info
->total_price
总金额String单位为分可空
trace_info
->overplus
剩余金额String表示单品类型的售价,或现金类型的剩余金额
单位为分
可空
trace_info
->use_flag
卡面状态String2:未核销
3:已赠送
4:已领取
5:未领取
6:转赠
7:核销
8:已失效
可空
trace_info
->consume_source
核销来源String可空
trace_info
->location_name
核销门店String可空
trace_info
->verify_time
核销时间String返回时间戳格式可空
trace_info
->req_seq
流水号String我方生成可空
trace_info
->pos_id
终端号String可空
trace_info
->store_id
门店号String可空
result->id响应码String(4)翼码平台返回的处理结果,0000-成功,其它失败,错误信息说明见“响应码解释”字段必填
result->comment响应码解释String(64)响应码对应中文注解,用于显示提示必填

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