交易请求报文
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 | 必填 |
标准接口会因业务升级需要而新增节点,请在解析返回报文时避免新增未知节点产生的程序出错!


