交易请求报文
<?xml version="1.0" encoding="GBK" ?>
<business_trans>
<request_type>card_query_request</request_type>
<isspid>39493002</isspid>
<pos_id>1511300001</pos_id>
<store_id>1511300001</store_id>
<pos_seq>1511300000001</pos_seq>
<user_id>user01</user_id>
<system_id>8888</system_id>
<card_query_request>
<valid_info>1234567890123456</valid_info>
<encode_type>099</encode_type>
</card_query_request>
</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-二维码 (已支持不传该节点自动判断) | 可选 |
交易返回报文
<?xml version="1.0" encoding="GBK"?>
<business_trans>
<response_type>card_query_response</response_type>
<isspid>39493002</isspid>
<pos_id>123456789</pos_id>
<pos_seq>000000000001</pos_seq>
<sys_seq>000000000244</sys_seq>
<trans_time>20090405010104</trans_time>
<query_info>
<order_id>123456789</order_id>
<batch_no>123456789</batch_no>
<batch_name>测试活动</batch_name>
<batch_short_name>测试活动</batch_short_name>
<use_type>1</use_type>
<va_status>2</va_status>
<end_use_time>20170316235959</end_use_time>
<remain_amt>1000</remain_amt>
<remain_times>10</remain_times>
<price>2000</price>
</query_info>
<verify_info>
<count>2</count>
<redeem>
<store_id>6666666666</store_id>
<pos_id>0001034843</pos_id>
<pos_seq>1607080000015</pos_seq>
<store_name>独立支付测试IPOS</store_name>
<trans_time>20160708162255</trans_time>
</redeem>
<redeem>
<store_id>6666666666</store_id>
<pos_id>0001034843</pos_id>
<pos_seq>1607080000015</pos_seq>
<store_name>独立支付测试IPOS</store_name>
<trans_time>20160708162255</trans_time>
</redeem>
</verify_info>
<result>
<id>0000</id>
<comment>成功</comment>
</result>
</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) | 验证时间 | 必填 |