业务说明
支持的交易类型:
4.2条码支付、4.3扫码支付、4.13jsapi支付、4.14微信小程序支付、4.21聚合动态码支付、4.22小程序支付收银台下单
交易请求报文
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"
},
"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>
</barcode_cancel_request>
</business_trans>
交易请求报文说明
节点名称 | 中文名称 | 类型 | 说明 | 是否必填 |
---|---|---|---|---|
sign | 报文签名 | String(32) | 请求报文格式为JSON时必填 计算签名方式请看2.1章节 | 可选 |
request_type | 请求类型 | String(32) | 固定值:barcode_cancel_request | 必填 |
isspid | 商户号 | String(8) | 翼码商户号,由翼码提供 | 必填 |
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:微信小程序 516:数字人民币 519:会员余额支付 521:聚分期 | 可空 |
barcode_cancel_request ->org_pos_seq | 支付请求流水号 | String(32) | 被撤销的支付请求流水号,且大于12位 | 必填 |
交易返回报文
JSON:
{
"response_type": "barcode_cancel_response",
"isspid": "00026713",
"pos_id": "6666666666",
"pos_seq": "2018121400000012",
"trans_time": "20181214152755",
"sys_seq": "f135e20440ea261b",
"pay_type": "502",
"extend": "<![CDATA[]]>",
"alipay_res_info": {
"trade_no": "",
"out_trade_no": "2018121400000010",
"detail_error_code": "",
"detail_error_desc": ""
},
"wxpay_res_info": {
"out_trade_no": "2018121400000011",
"app_id": "wx5acb63e448b4fc22",
"mch_id": "1241109502",
"detail_error_code": "",
"detail_error_desc": ""
},
"wxapp_res_info": {
"out_trade_no": "2018121400000011",
"app_id": "wx5acb63e448b4fc22",
"mch_id": "1241109502",
"detail_error_code": "",
"detail_error_desc": ""
},
"upay_res_info": {
"trade_no": "",
"out_trade_no": "2018121400000011"
},
"balpay_res_info": {
"trade_no": "4200000196201812146252898537",
"out_trade_no": "2018121400000002",
"cancel_amount": 1,
"gmt_cancel_pay": "20210205111441",
"member_id": "1452",
},
"jfqpay_res_info": {
"trade_no": "",
"out_trade_no": "2018121400000011"
},
"result": {
"id": "0000",
"comment": "交易成功"
},
"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>20090405010104</trans_time>
<pay_type>502</pay_type>
<extend><![CDATA[扩展字段(json格式)]]></extend>
<alipay_res_info>
<trade_no>2014110721001004640000791910</trade_no>
<out_trade_no>2014110721001004640000791910</out_trade_no>
<detail_error_code></detail_error_code>
<detail_error_desc></detail_error_desc>
</alipay_res_info>
<wxpay_res_info>
<out_trade_no>2014110721001004640000791910</out_trade_no>
<app_id>2014110721001004640000791910</app_id>
<mch_id>2014110721001004640000791910</mch_id>
<detail_error_code></detail_error_code>
<detail_error_desc></detail_error_desc>
</wxpay_res_info>
<wxapp_res_info>
<out_trade_no>2014110721001004640000791910</out_trade_no>
<app_id>2014110721001004640000791910</app_id>
<mch_id>2014110721001004640000791910</mch_id>
<detail_error_code></detail_error_code>
<detail_error_desc></detail_error_desc>
</wxapp_res_info>
<upay_res_info>
<trade_no>2014110721001004640000791910</trade_no>
<out_trade_no>2014110721001004640000791910</out_trade_no>
</upay_res_info>
<balpay_res_info>
<trade_no>15415906</trade_no>
<out_trade_no>1000000000511</out_trade_no>
<cancel_amount>1</cancel_amount>
<gmt_cancel_pay>20210205111441</gmt_cancel_pay>
<member_id>1452</member_id>
</balpay_res_info>
<jfqpay_res_info>
<trade_no>2014110721001004640000791910</trade_no>
<out_trade_no>2014110721001004640000791910</out_trade_no>
</jfqpay_res_info>
<result>
<id>0000</id>
<comment>成功</comment>
</result>
</business_trans>
交易返回报文说明
标准接口会因业务升级需要而新增节点,请在解析返回报文时避免新增未知节点产生的程序出错!
节点名称 | 中文名称 | 类型 | 说明 | 是否必填 |
---|---|---|---|---|
sign | 报文签名 | String(32) | 返回报文格式为JSON时必填 计算签名方式请看2.1章节 | 可选 |
response_type | 返回类型 | String(32) | 固定值:barcode_cancel_response | 必填 |
isspid | 商户号 | String(8) | 翼码商户号,由翼码提供 | 必填 |
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:微信小程序 516:数字人民币 519:会员余额支付 521:聚分期 | 必填 |
extend | 扩展信息 | String | 扩展信息字段内容为json格式 预留字段后续业务扩展使用 | 可空 |
result ->id | 响应码 | String(4) | 0000:成功 其它代表失败,错误信息说明见“响应码解释”字段 | 必填 |
result ->comment | 响应码解释 | String(64) | 响应码对应中文注解,用于显示提示 | 必填 |
支付宝返回返回以下数据 | ||||
alipay_res_info ->trade_no | 支付宝订单号 | String(64) | 直连通道交易成功时候,必填 | 可空 |
alipay_res_info ->out_trade_no | 支付商户订单号 | String(64) | 直连通道交易成功时候,必填 | 可空 |
alipay_res_info ->detail_error_code | 支付详细错误码 | String(48) | ||
alipay_res_info ->detail_error_desc | 支付详细错误码说明 | String(64) | ||
微信支付返回返回以下数据 | ||||
wxpay_res_info ->out_trade_no | 微信订单号 | String(64) | 直连通道交易成功时候,必填 | 可空 |
wxpay_res_info ->detail_error_code | 支付商户订单号 | String(48) | 直连通道交易成功时候,必填 | 可空 |
wxpay_res_info ->detail_error_desc | 支付详细错误码说明 | String(128) | 直连通道交易成功时候,必填 | 可空 |
wxpay_res_info ->app_id | 微信公众帐号 | String(32) | 直连通道交易成功时候,必填 | 可空 |
wxpay_res_info ->mch_id | 微信商户帐号 | String(32) | 直连通道交易成功时候,必填 | 可空 |
微信小程序返回返回以下数据 | ||||
wxapp_res_info ->out_trade_no | 微信订单号 | String(64) | 直连通道交易成功时候,必填 | 可空 |
wxapp_res_info ->detail_error_code | 支付商户订单号 | String(48) | 直连通道交易成功时候,必填 | 可空 |
wxapp_res_info ->detail_error_desc | 支付详细错误码说明 | String(128) | 直连通道交易成功时候,必填 | 可空 |
wxapp_res_info ->app_id | 微信公众帐号 | String(32) | 直连通道交易成功时候,必填 | 可空 |
wxapp_res_info ->mch_id | 微信商户帐号 | String(32) | 直连通道交易成功时候,必填 | 可空 |
银联二维码返回返回以下数据 | ||||
upay_res_info ->trade_no | 银联订单号 | String(64) | 直连通道交易成功时候,必填 | 可空 |
upay_res_info ->out_trade_no | 支付商户订单号 | String(64) | 直连通道交易成功时候,必填 | 可空 |
会员余额支付返回返回以下数据 | ||||
balpay_res_info ->trade_no | 支付平台订单号 | String(64) | 可空 | |
balpay_res_info ->out_trade_no | 支付商户订单号 | String(64) | 可空 | |
balpay_res_info ->cancel_amount | 撤销金额 | String(9) | 单位为分 | 可空 |
balpay_res_info ->gmt_cancel_pay | 撤销完成时间 | String(14) | 格式:yyyyMMddHHmmss | 可空 |
balpay_res_info ->member_id | 会员id | String(9) | 可空 | |
聚分期返回返回以下数据 | ||||
jfqpay_res_info ->trade_no | 支付平台订单号 | String(64) | 可空 | |
jfqpay_res_info ->out_trade_no | 支付商户订单号 | String(64) | 可空 |
标准接口会因业务升级需要而新增节点,请在解析返回报文时避免新增未知节点产生的程序出错!