交易请求报文
<?xml version="1.0" encoding="GBK"?>
<business_trans>
<request_type>card_verify_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_verify_request>
<valid_info>1234567890123456</valid_info>
<encode_type>099</encode_type>
<tx_amt>1000</tx_amt>
</card_verify_request>
</business_trans>
交易请求报文说明
节点名称 | 中文名称 | 类型 | 说明 | 是否 必填 |
---|---|---|---|---|
request_type | 请求类型 | String(32) | 标识请求报文的类型,固定为card_verify_request | 必填 |
isspid | 商户号 | String(8) | 接入SP的ID号,,由翼码凭证通支撑平台分配给ipos接入受理商户的机构号(原值返回) | 必填 |
pos_id | 终端号 | String(20) | 终端号 | 必填 |
store_id | 门店号 | String(20) | 门店号 | 必填 |
pos_seq | 终端流水号 | String(32) | 同一个商户必须唯一,且大于12位 | 必填 |
user_id | 操作员标识 | String(20) | 操作员号 | 可空 |
system_id | 系统平台号 | String(4) | 由翼码提供 | 必填 |
card_verify_request ->valid_info | 验证数据 | String(256) | 辅助码为明文(12或16位数字); 二维码为条码内容 | 必填 |
card_verify_request ->encode_type | 验证数据类型 | String(3) | 099-辅助码 098-二维码 (已支持不传该节点自动判断) | 可选 |
card_verify_request ->tx_amt | 交易金额 | Number(16) | 金额验证时候,终端输入的本次交易金额,单位“分” | 按金额验证时必填 |
交易返回报文
<?xml version="1.0" encoding="GBK"?>
<business_trans>
<response_type>card_verify_response</response_type>
<isspid>39493002</isspid>
<pos_id>1511300001</pos_id>
<pos_seq>1511300000001</pos_seq>
<sys_seq>000000000244</sys_seq>
<trans_time>20090405010104</trans_time>
<addition_info>
<print_text>打印文本</print_text>
<tx_amt>1000</tx_amt>
</addition_info>
<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>1000</price>
</query_info>
<result>
<id>0000</id>
<comment>成功</comment>
</result>
</business_trans>
交易返回报文说明
节点名称 | 中文名称 | 类型 | 说明 | 是否 必填 |
---|---|---|---|---|
response_type | 返回类型 | String(32) | 标识返回报文的类型,固定为card_verify_response | 必填 |
isspid | 商户号 | String(8) | 接入SP的ID号,为翼码凭证平台的提供的业务商机构号 | 必填 |
pos_id | 终端号 | String(20) | 终端号 | 必填 |
pos_seq | 终端流水号 | String(32) | 终端交易流水号,和请求报文中的交易流水号相同 | 必填 |
sys_seq | 平台流水号 | String(22) | 由条码支撑平台产生,供跟踪之用 | 必填 |
trans_time | 交易时间 | String(14) | 交易时间,格式:yyyymmddhh24miss | 必填 |
system_id | 系统平台号 | String(4) | 由翼码提供 | 必填 |
addition_info ->print_text | 打印文本 | String(1000) | 交易成功打印内容 | 可空 |
addition_info ->tx_amt | 交易金额 | Number(10) | 交易金额 | 可空 |
result ->id | 响应码 | String(4) | 条码支撑平台返回的处理结果,0000-成功,其它失败,错误信息说明见“响应码解释”字段 | 必填 |
result ->comment | 响应码解释 | String(64) | 响应码对应中文注解,用于显示提示 | 必填 |
验证成功后返回 | 以下条码活动信息 | |||
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 | 卡券面值,单位:分 | 次数型时必填 |