交易请求报文
JSON:
{
"request_type": "barcode_cancel_request",
"isspid": "39493002",
"pos_id": "6666666666",
"store_id": "6666666666",
"pos_seq": "2018121400000012",
"user_id": "user01",
"system_id": "8888",
"barcode_cancel_request": {
"pay_type": "",
"org_pos_seq": "2018121400000010" ,
"org_trade_no": "xxxxxxxxxxxxx",
"pos_sn": "xxxxxxxxx"
},
"sign": "38C73CFED3B3C6E0ED18AF04E8D34D94"
}
XML:
<?xml version="1.0" encoding="GBK"?>
<business_trans>
<request_type>barcode_cancel_request</request_type>
<isspid>39493002</isspid>
<pos_id>1511300001</pos_id>
<store_id>1511300001</store_id>
<pos_seq>1511300000004</pos_seq>
<user_id>user01</user_id>
<system_id>8888</system_id>
<barcode_cancel_request>
<pay_type>502</pay_type>
<org_pos_seq>1511300000001</org_pos_seq>
<org_trade_no>xxxxxxxxxx</org_trade_no>
<pos_sn>xxxxxxxxxx</pos_sn>
</barcode_cancel_request>
</business_trans>
交易请求报文说明
节点名称 | 中文名称 | 类型 | 说明 | 是否必填 |
---|---|---|---|---|
sign | 报文签名 | String(32) | 请求报文格式为JSON时必填 计算签名方式请看2.1章节 | 可选 |
request_type | 请求类型 | String(32) | 标识请求报文的类型,固定为barcode_cancel_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_cancel_request ->pay_type | 支付类型 | String(3) | 502:支付宝支付 503:微信支付 512:银联二维码 515:小程序支付 | 可空 |
barcode_cancel_request ->org_pos_seq | 需要撤销交易的流水号 | String(32) | 需要撤销的原支付流水号,且大于12位 | 必填 |
barcode_cancel_request ->pos_sn | 设备sn号 | String | 设备sn号,设备上可查看 | 必填 |
barcode_cancel_request ->org_trade_no | 原系统交易流水 | String | 交易请求/查询交易返回的trade_no | 必填 |
交易返回报文
JSON:
{
"response_type": "barcode_cancel_response",
"isspid": "00026713",
"pos_id": "6666666666",
"pos_seq": "2018121400000012",
"sys_seq": "f135e20440ea261b",
"trans_time" "20201130111111",
"pay_type": "502",
"extend": "<![CDATA[]]>",
"result": {
"id": "0000",
"comment": "交易成功"
},
"pay_response": {
"trade_no": "xxxxxxxxxxx",
"receipt_amount": "10",
"trans_time": "20201130111111"
},
"sign": "F3417D5E9CEF3AE32110C7EFBF5AB400"
}
XML:
<?xml version="1.0" encoding="GBK"?>
<business_trans>
<response_type>barcode_cancel_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>
<trade_no>xxxxxxxxxxxxxxx</trade_no>
<receipt_amount>10</receipt_amount>
<trans_time>20090405010104</trans_time>
</pay_response>
</business_trans>
交易返回报文说明
标准接口会因业务升级需要而新增节点,请在解析返回报文时避免新增未知节点产生的程序出错!
节点名称 | 中文名称 | 类型 | 说明 | 是否必填 |
---|---|---|---|---|
sign | 报文签名 | String(32) | 返回报文格式为JSON时必填 计算签名方式请看2.1章节 | 可选 |
response_type | 返回类型 | String(32) | 标识返回报文的类型,固定为barcode_cancel_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-成功,其它失败,错误信息说明见“响应码解释”字段 | 必填 |
result ->comment | 响应码解释 | String(64) | 响应码对应中文注解,用于显示提示 | 必填 |
交易返回数据 pay_response | 仅result->id返回为0000时返回以下数据 | 可空 | ||
pay_response ->trade_no | 系统交易流水号 | String | 支付宝、微信等平台返回的交易流水号 | 必填 |
pay_response ->receipt_amount | 实际撤销金额 | Number(9) | 单位:分,不支持小数 | 必填 |
pay_response ->trans_time | 系统交易时间 | String(14) | 支付宝、微信等系统交易时间,格式:yyyyMMddHHmmss | 必填 |
标准接口会因业务升级需要而新增节点,请在解析返回报文时避免新增未知节点产生的程序出错!