交易请求报文
<?xml version="1.0" encoding="GBK"?>
<business_trans>
<request_type>wecard_getcodeinfo_request</request_type>
<isspid>39493002</isspid>
<transaction_id>1511300000004</transaction_id>
<system_id>8888</system_id>
<code>1111111111</code>
<encrypt_code></encrypt_code>
</business_trans>
交易请求报文说明
节点名称 | 中文名称 | 类型 | 说明 | 是否必填 |
---|---|---|---|---|
request_type | 请求类型 | String(32) | 标识请求报文的类型,固定为wecard_getcodeinfo_request | 必填 |
isspid | 商户号 | String(8) | 接入SP的ID号,由翼码平台分配给ipos接入受理商户的机构号(原值返回) | 必填 |
transaction_id | 请求流水号 | String | 不校验格式,建议随机唯一值方便快速查找日志 | 可空 |
system_id | 系统平台号 | String(4) | 由翼码提供 | 必填 |
code | 礼品卡code | String | 礼品卡code | 可空 |
encrypt_code | 微信加密后的code | String | 用于获取code使用 | 可空 |
交易返回报文
<?xml version="1.0" encoding="GBK"?>
<business_trans>
<response_type>wecard_getcodeinfo_response</response_type>
<isspid>39493002</isspid>
<transaction_id>190213000000000003</transaction_id>
<extend></extend>
<base_info>
<brand_name>zy测试</brand_name>
<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>
<card_type>2</card_type>
<title>张亚的礼品卡</title>
<use_all_locations>1</use_all_locations>
<location_id_list></location_id_list>
<service_phone></service_phone>
<cancel_type>3</cancel_type>
<stock>6</stock>
<time_type>DATE_TYPE_FIX_TIME_RANGE</time_type>
<begin>1549814400</begin>
<end>1550073599</end>
</base_info>
<trace_info>
<node_id>1006</node_id>
<order_id>AQAAYfBdcLRuhXBkBgWZ2Y6m3RKG</order_id>
<card_id>pBZnZjo-nSrhYjUyOHPr4s4fDcvo</card_id>
<user_card_code>2234100004129</user_card_code>
<total_price>1</total_price>
<overplus>1000</overplus>
<use_flag>3</use_flag>
<consume_source></consume_source>
<location_name></location_name>
<verify_time></verify_time>
<req_seq></req_seq>
<pos_id>00000000</pos_id>
<store_id></store_id>
</trace_info>
<result>
<id>0000</id>
<comment>查询成功</comment>
</result>
</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 | 商户logo | String | 用CDATA标签包裹 | 可空 |
base_info ->card_type | 礼品卡类型 | String | 2:单品 3:现金 | 可空 |
base_info ->title | 礼品卡名称 | String | 可空 | |
base_info ->use_all_locations | 是否全门店 | String | 0:否 1:是 | 可空 |
base_info ->location_id_list | 可使用门店ID | String | 多门店ID以英文逗号“,”分隔 | 可空 |
base_info ->service_phone | 商户电话号码 | String | 可空 | |
base_info ->cancel_type | 核销方式 | String | 2:自助核销 3:为扫码核销 | 可空 |
base_info ->stock | 商品库存 | String | 可空 | |
base_info ->time_type | 时间类型 | String | DATE_TYPE_FIX_TIME_RANGE:固定时长类型 DATE_TYPE_FIX_TERM:固定日期类型 | 可空 |
base_info ->begin | 开始时间 | String | DATE_TYPE_FIX_TIME_RANGE类型返回秒级时间戳 DATE_TYPE_FIX_TERM类型返回天数 | 可空 |
base_info ->end | 结束时间 | String | DATE_TYPE_FIX_TIME_RANGE类型返回秒级时间戳 DATE_TYPE_FIX_TERM类型返回天数 | 可空 |
trace_info ->node_id | 商户唯一id | String | 可空 | |
trace_info ->order_id | 订单id | String | 可空 | |
trace_info ->card_id | 礼品卡id | String | 可空 | |
trace_info ->user_card_code | code | String | 可空 | |
trace_info ->total_price | 总金额 | String | 单位为分 | 可空 |
trace_info ->overplus | 剩余金额 | String | 表示单品类型的售价,或现金类型的剩余金额 单位为分 | 可空 |
trace_info ->use_flag | 卡面状态 | String | 2:未核销 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) | 响应码对应中文注解,用于显示提示 | 必填 |
标准接口会因业务升级需要而新增节点,请在解析返回报文时避免新增未知节点产生的程序出错!