业务说明
应用场景
可调用快捷绑卡解绑接口完成快捷绑卡的解约操作。
交易请求报文
JSON:
{
"request_type": "online_quickbuckle_unbind_request",
"isspid": "39493002",
"pos_id": "0001",
"store_id": "0001",
"pos_seq": "qbu_20240301235959000001",
"user_id": "user01",
"system_id": "8888",
"mch_name": "翼码科技",
"mch_cust_id": "U0000001",
"card_token_no": "10000093623",
"sign": "314DA43E7E244105ECBD45F797264854"
}
XML:
<?xml version="1.0" encoding="GBK"?>
<business_trans>
<request_type>online_quickbuckle_unbind_request</request_type>
<isspid>39493002</isspid>
<pos_id>0001</pos_id>
<store_id>0001</store_id>
<pos_seq>qbu_20240301235959000001</pos_seq>
<user_id>user01</user_id>
<system_id>8888</system_id>
<mch_name>翼码科技</mch_name>
<mch_cust_id>U0000001</mch_cust_id>
<card_token_no>10000093623</card_token_no>
</business_trans>
交易请求报文说明
节点名称 | 中文名称 | 类型 | 说明 | 是否必填 |
---|---|---|---|---|
sign | 报文签名 | String(32) | 请求报文格式为JSON时必填 计算签名方式请看2.1章节 | 可空 |
request_type | 请求类型 | String(32) | 固定值:online_quickbuckle_unbind_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) | 由翼码提供 | 必填 |
mch_name | 商户名称 | String(128) | 可空 | |
mch_cust_id | 商户用户id | String(64) | 对应【快捷绑卡确认】返回节点中的mch_cust_id | 必填 |
card_token_no | 绑卡序列号 | String(64) | 对应【快捷绑卡确认】返回节点中的card_token_no | 必填 |
自定义门店号(store_id)和自定义终端号(pos_id)需经过4.1终端绑定交易接口绑定成功过的值才可以调用,绑定一次即可不需要重复绑定。
交易返回报文
JSON:
{
"response_type": "online_quickbuckle_unbind_response",
"isspid": "39493002",
"pos_id": "0001",
"pos_seq": "qbu_20240301235959000001",
"trans_time": "20240301151515",
"sys_seq": "0741136885a748c1",
"result": {
"id": "0000",
"comment": "解绑成功"
},
"sign": "F6106656C20AB23B547B0C30DD819793"
}
XML:
<?xml version="1.0" encoding="GBK"?>
<business_trans>
<response_type>online_quickbuckle_unbind_response</response_type>
<isspid>39493002</isspid>
<pos_id>0001</pos_id>
<pos_seq>qbu_20240301235959000001</pos_seq>
<sys_seq>0741136885a748c1</sys_seq>
<trans_time>20240301151515</trans_time>
<result>
<id>0000</id>
<comment>解绑成功</comment>
</result>
</business_trans>
交易返回报文说明
标准接口会因业务升级需要而新增节点,请在解析返回报文时避免新增未知节点产生的程序出错!
节点名称 | 中文名称 | 类型 | 说明 | 是否必填 |
---|---|---|---|---|
sign | 报文签名 | String(32) | 返回报文格式为JSON时必填 计算签名方式请看2.1章节 | 可选 |
response_type | 返回类型 | String(32) | 固定值:online_quickbuckle_unbind_response | 必填 |
isspid | 商户号 | String(8) | 翼码商户号,由翼码提供 | 必填 |
pos_id | 终端号 | String(20) | 商户自定义终端号 | 必填 |
pos_seq | 绑卡解绑流水号 | String(32) | 绑卡解绑流水号,和请求报文相同 | 必填 |
sys_seq | 随机串号 | String(16) | 随机生成串号,仅用于日志跟踪用,不保存 | 必填 |
trans_time | 接口返回时间 | String(14) | 接口返回时间,格式:yyyyMMddHHmmss | 必填 |
result ->id | 响应码 | String(4) | 0000:解绑成功 其它表示失败,错误信息说明见“响应码解释”字段 | 必填 |
result ->comment | 响应码解释 | String(64) | 响应码对应中文注解,用于显示提示 | 必填 |
标准接口会因业务升级需要而新增节点,请在解析返回报文时避免新增未知节点产生的程序出错!