交易请求报文

  1. <?xml version="1.0" encoding="GBK"?>
  2. <business_trans>
  3. <request_type>wecard_poscancelcard_request</request_type>
  4. <isspid>39493002</isspid>
  5. <pos_id>1511300001</pos_id>
  6. <store_id>1511300001</store_id>
  7. <pos_seq>1902140000000005</pos_seq>
  8. <system_id>8888</system_id>
  9. <code>11111111</code>
  10. <consume_source>核销渠道</consume_source>
  11. <amount>125</amount>
  12. </business_trans>

交易请求报文说明

节点名称中文名称类型说明是否必填
request_type请求类型String(32)标识请求报文的类型,固定为wecard_poscancelcard_request必填
isspid商户号String(8)接入SP的ID号,由翼码平台分配给ipos接入受理商户的机构号(原值返回)必填
store_id门店号String(20)门店号必填
pos_id终端号String(20)终端号必填
pos_seq终端流水号String(32)同一个商户必须唯一,且大于12位必填
system_id系统平台号String(4)由翼码提供必填
code礼品卡codeString礼品卡code必填
consume_source核销渠道String必填
amount交易金额String单位为分
需要核销的金额,不传默认为一般礼品卡
可选

交易返回报文

  1. <?xml version="1.0" encoding="GBK"?>
  2. <business_trans>
  3. <response_type>wecard_poscancelcard_response</response_type>
  4. <isspid>39493002</isspid>
  5. <pos_id>6666666666</pos_id>
  6. <pos_seq>1902140000000010</pos_seq>
  7. <extend></extend>
  8. <info>
  9. <node_id>1006</node_id>
  10. <code>267373474047</code>
  11. <pos_id>0001034843</pos_id>
  12. <location_name>独立支付测试IPOS</location_name>
  13. <card_id>pBZnZjtKfZ74gaSvmiJ0IK1d36Jw</card_id>
  14. <store_id>01032000</store_id>
  15. <consume_source>核销渠道</consume_source>
  16. <amount>125</amount>
  17. <balance>748</balance>
  18. <req_seq>1902140000000010</req_seq>
  19. <type>3</type>
  20. <card_name>zy金额型礼品卡</card_name>
  21. <brand_name>zy测试</brand_name>
  22. <create_time>1550127597</create_time>
  23. <overplus>623</overplus>
  24. <return_code>ok</return_code>
  25. <return_msg>ok</return_msg>
  26. </info>
  27. <result>
  28. <id>0000</id>
  29. <comment>核销成功</comment>
  30. </result>
  31. </business_trans>

交易返回报文说明

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

节点名称中文名称类型说明是否必填
response_type返回类型String(32)标识返回报文的类型,固定为wecard_poscancelcard_response必填
isspid商户号String(8)接入SP的ID号,为翼码平台的提供的业务商机构号必填
pos_id终端号String(20)终端号必填
pos_seq终端流水号String(32)终端交易流水号,和请求报文中的交易流水相同必填
extend扩展信息String扩展信息字段内容为json格式
预留字段后续业务扩展使用
可空
info核销信息array核销成功必填可空
info->node_id商户唯一标识String可空
info->code礼品卡codeString可空
info->pos_id终端号String可空
info->location_name门店名称String可空
info->card_id礼品卡卡号String可空
info->store_id门店号String可空
info->consume_source核销渠道String可空
info->amount礼品卡使用金额String兑换类设置为0
单位为分
可空
info->balance礼品卡使用前剩余金额String兑换类设置为0
单位为分
可空
info->req_seq核销流水号String可空
info->type礼品卡类型String2:兑换类
3:储值类
可空
info->card_name礼品名称String可空
info->brand_name礼品卡商户名称String可空
info->create_time流水生成时间String时间戳格式可空
info->overplus礼品卡使用后剩余金额String兑换类设置为0
单位为分
可空
info->return_code返回状态码String可空
info->return_msg返回错误信息String可空
result->id响应码String(4)翼码平台返回的处理结果,0000-成功,其它失败,错误信息说明见“响应码解释”字段必填
result->comment响应码解释String(64)响应码对应中文注解,用于显示提示必填

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