交易请求报文
JSON:
{
"request_type": "barcode_refundquery_request",
"isspid": "39493002",
"pos_id": "8888888888",
"store_id": "8888888888",
"pos_seq": "2018121400000008",
"user_id": "user01",
"system_id": "8888",
"barcode_refundquery_request": {
"pay_type": "502",
"org_pos_seq": "2018121400000006" ,
"pos_sn": "xxxxxxxxxxxxx"
},
"sign": "A95561E9CBB30BD049000FD9C530B1AF"
}
XML:
<?xml version="1.0" encoding="GBK"?>
<business_trans>
<request_type>barcode_refundquery_request</request_type>
<isspid>39493002</isspid>
<pos_id>1511300001</pos_id>
<store_id>1511300001</store_id>
<pos_seq>1511300000003</pos_seq>
<user_id>user01</user_id>
<system_id>8888</system_id>
<barcode_refundquery_request>
<pay_type>502</pay_type>
<org_pos_seq>1511300000001</org_pos_seq>
<pos_sn>xxxxxxxxxx</pos_sn>
</barcode_refundquery_request>
</business_trans>
交易请求报文说明
节点名称 | 中文名称 | 类型 | 说明 | 是否必填 |
---|---|---|---|---|
sign | 报文签名 | String(32) | 请求报文格式为JSON时必填 计算签名方式请看2.1章节 | 可选 |
request_type | 请求类型 | String(32) | 标识请求报文的类型,固定为barcode_refundquery_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) | 由翼码提供 | 必填 |
barcode_refundquery_request ->pay_type | 支付类型 | String(3) | 502:支付宝支付 503:微信支付 512:银联二维码 515:小程序支付 | 可空 |
barcode_refundquery_request ->org_pos_seq | 需要查询的退款交易流水号 | String(32) | 需要查询的退款交易流水号,且大于12位 | 必填 |
barcode_refundquery_request ->pos_sn | 设备sn号 | String | 设备sn号,设备上可查看 | 必填 |
交易返回报文
JSON:
{
"response_type": "barcode_refundquery_response",
"isspid": "39493002",
"pos_id": "8888888888",
"pos_seq": "2018121400000008",
"sys_seq": "a4507a682d26403a",
"trans_time" "20201130111111",
"pay_type": "502",
"extend": "<![CDATA[]]>",
"result": {
"id": "0000",
"comment": "交易成功"
},
"pay_response": {
"trans_amount": "10",
"amount": "10",
"trade_no": "xxxxxxxxxxx",
"trans_time": "20201130111111"
},
"sign": "B94B9113A279C761A831C5B592E0BF09"
}
XML:
<?xml version="1.0" encoding="GBK"?>
<business_trans>
<response_type>barcode_refundquery_response</response_type>
<isspid>39493002</isspid>
<pos_id>123456789</pos_id>
<pos_seq>000000000001</pos_seq>
<sys_seq>000000000244</sys_seq>
<trans_time>20201130111111</trans_time>
<pay_type>502</pay_type>
<extend><![CDATA[扩展字段(json格式)]]></extend>
<result>
<id>0000</id>
<comment>成功</comment>
</result>
<pay_response>
<trans_amount>10</trans_amount>
<amount>10</amount>
<trade_no>xxxxxxxxx</trade_no>
<total_fee>10</total_fee>
<trans_time>20201130111111</trans_time>
</pay_response>
</business_trans>
交易返回报文说明
标准接口会因业务升级需要而新增节点,请在解析返回报文时避免新增未知节点产生的程序出错!
节点名称 | 中文名称 | 类型 | 说明 | 是否必填 |
---|---|---|---|---|
sign | 报文签名 | String(32) | 返回报文格式为JSON时必填 计算签名方式请看2.1章节 | 可选 |
response_type | 返回类型 | String(32) | 标识返回报文的类型,固定为barcode_refundquery_response | 必填 |
isspid | 商户号 | String(8) | 接入SP的ID号,为翼码平台的提供的业务商机构号 | 必填 |
pos_id | 终端号 | String(20) | 终端号 | 必填 |
pos_seq | 终端流水号 | String(32) | 终端交易流水号,和请求报文中的交易流水号相同 | 可选 |
sys_seq | 随机串号 | String(16) | 随机生成串号,仅用于日志跟踪用,不保存 | 必填 |
trans_time | 交易时间 | String(14) | 交易时间,格式:yyyyMMddHHmmss | 必填 |
pay_type | 支付类型 | String(3) | 502:支付宝支付 503:微信支付 512:银联二维码 515:小程序支付 | 必填 |
extend | 扩展信息 | String | 扩展信息字段内容为json格式 预留字段后续业务扩展使用 | 可空 |
result ->id | 响应码 | String(4) | 翼码平台返回的处理结果 0000-成功 9998-退款处理中,需要调用退款查询交易确认退款结果 其它为失败,错误信息说明见“响应码解释”字段 | 必填 |
result ->comment | 响应码解释 | String(64) | 响应码对应中文注解,用于显示提示 | 必填 |
交易返回数据 pay_response | 仅result->id返回为0000时返回以下数据 | 可空 | ||
pay_response ->trans_amount | 实际退款金额 | Number(9) | 单位:分,不支持小数 | 必填 |
pay_response ->amount | 请求退款金额 | Number(9) | 单位:分,不支持小数 | 必填 |
pay_response ->trade_no | 系统交易流水 | String | 支付宝、微信、银联等返回的交易流水号 | 必填 |
pay_response ->total_fee | 交易订单金额 | Number(9) | 支付时的订单金额 | 必填 |
pay_response ->trans_time | 系统交易时间 | String(14) | 支付宝、微信等系统交易时间,格式:yyyyMMddHHmmss | 必填 |
标准接口会因业务升级需要而新增节点,请在解析返回报文时避免新增未知节点产生的程序出错!