业务说明
应用场景
支持快捷支付绑卡申请。上送持卡人四要素信息(银行卡、户名、证件号、银行留存手机号)进行验证,验证成功后银行会向持卡人的银行留存手机号发送短信验证码。
交易请求报文
JSON:
{
"request_type": "online_quickbuckle_apply_request",
"isspid": "39493002",
"pos_id": "0001",
"store_id": "0001",
"pos_seq": "qba_20240301235959000001",
"user_id": "user01",
"system_id": "8888",
"mch_name": "翼码科技",
"mch_cust_id": "U0000001",
"email": "1@qq.com",
"card_no": "620000000000000000001",
"card_name": "张三",
"cert_id": "350102000000000001",
"cert_validity_type": "0",
"cert_begin_date": "20220618",
"cert_end_date": "20420618",
"card_mp": "18600000001",
"vip_code": "618",
"expiration": "0426",
"dc_type": "C",
"protocol_no": "34463343",
"device_ip": "127.0.0.1",
"device_type": "4",
"device_mac": "0C-96-E6-84-1E-11",
"device_imei": "460030912121001",
"device_imsi": "460030912121001",
"device_icc_id": "898600680113F0123014",
"device_wifi_mac": "96-87-78-69-5A-4B",
"latitude": "+37.12",
"longitude": "-121.213",
"sign": "314DA43E7E244105ECBD45F797264854"
}
XML:
<?xml version="1.0" encoding="GBK"?>
<business_trans>
<request_type>online_quickbuckle_apply_request</request_type>
<isspid>39493002</isspid>
<pos_id>0001</pos_id>
<store_id>0001</store_id>
<pos_seq>qba_20240301235959000001</pos_seq>
<user_id>user01</user_id>
<system_id>8888</system_id>
<mch_name>翼码科技</mch_name>
<mch_cust_id>U0000001</mch_cust_id>
<email>1@qq.com</email>
<card_no>620000000000000000001</card_no>
<card_name>张三</card_name>
<cert_id>350102000000000001</cert_id>
<cert_validity_type>0</cert_validity_type>
<cert_begin_date>20220618</cert_begin_date>
<cert_end_date>20420618</cert_end_date>
<card_mp>18600000001</card_mp>
<vip_code>618</vip_code>
<expiration>0426</expiration>
<dc_type>C</dc_type>
<protocol_no>34463343</protocol_no>
<device_ip>127.0.0.1</device_ip>
<device_type>4</device_type>
<device_mac>0C-96-E6-84-1E-11</device_mac>
<device_imei>460030912121001</device_imei>
<device_imsi>460030912121001</device_imsi>
<device_icc_id>898600680113F0123014</device_icc_id>
<device_wifi_mac>96-87-78-69-5A-4B</device_wifi_mac>
<latitude>+37.12</latitude>
<longitude>-121.213</longitude>
</business_trans>
交易请求报文说明
节点名称 | 中文名称 | 类型 | 说明 | 是否必填 |
---|---|---|---|---|
sign | 报文签名 | String(32) | 请求报文格式为JSON时必填 计算签名方式请看2.1章节 | 可空 |
request_type | 请求类型 | String(32) | 固定值:online_quickbuckle_apply_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) | 用户在商户侧生成的用户号 同一用户不要反复生成不同的用户id | 必填 |
电子邮箱 | String(40) | 可空 | ||
card_no | 银行卡号 | String(64) | 必填 | |
card_name | 银行卡开户姓名 | String(64) | 必填 | |
cert_id | 银行卡绑定身份证号 | String(64) | 必填 | |
cert_validity_type | 个人证件有效期类型 | String(1) | 1:长期有效 0:非长期有效 | 必填 |
cert_begin_date | 个人证件有效期起始日 | String(8) | 格式:yyyyMMdd | 必填 |
cert_end_date | 个人证件有效期到期日 | String(8) | 格式:yyyyMMdd 长期有效不填,非长期有效必填 | 可选 |
card_mp | 银行卡绑定手机号 | String(11) | 11位数字,不包括+86等信息 | 必填 |
vip_code | CVV2安全码 | String(3) | 信用卡交易必填 | 可选 |
expiration | 卡有效期 | String(4) | 格式:MMYY 信用卡交易必填 | 可选 |
dc_type | 卡的借贷类型 | String(1) | C:信用卡 D:借记卡 S:准贷记 U:未知卡 | 可空 |
protocol_no | 挂网协议编号 | String(32) | 招行绑卡必填 招行固定填写值:34463343 | 可选 |
device_ip | 设备IP | String(15) | 设备所在的公网IP,可用于定位所属地区 不是wifi连接时的局域网IP IPV4格式 | 必填 |
device_type | 设备类型 | String(1) | 1:手机 2:平板 3:手表 4:PC | 必填 |
device_mac | 设备终端的物理地址 | String(64) | 必填 | |
device_imei | 交易设备IMEI | String(64) | 移动终端设备的唯一标识 | 必填 |
device_imsi | 交易设备IMSI | String(64) | 必填 | |
device_icc_id | 交易设备ICCID | String(64) | 必填 | |
device_wifi_mac | 交易设备WIFIMAC | String(64) | 必填 | |
latitude | 纬度 | String(9) | 交易设备的经纬度信息 纬度格式:+表示北纬,-表示南纬;纬度整数位不超过2位,小数位不超过6位。 | 必填 |
longitude | 经度 | String(9) | 交易设备的经纬度信息 经度格式:+表示东经,-表示西经;经度整数位不超过3位,小数位不超过5位。 | 必填 |
自定义门店号(store_id)和自定义终端号(pos_id)需经过4.1终端绑定交易接口绑定成功过的值才可以调用,绑定一次即可不需要重复绑定。
交易返回报文
JSON:
{
"response_type": "online_quickbuckle_apply_response",
"isspid": "39493002",
"pos_id": "0001",
"pos_seq": "qba_20240301151515000001",
"sys_seq": "0741136885a748c1",
"trans_time": "20240301151515",
"verify_id": "qba_20240301151515000001",
"result": {
"id": "0000",
"comment": "申请成功"
},
"sign": "F6106656C20AB23B547B0C30DD819793"
}
XML:
<?xml version="1.0" encoding="GBK"?>
<business_trans>
<response_type>online_quickbuckle_apply_response</response_type>
<isspid>39493002</isspid>
<pos_id>0001</pos_id>
<pos_seq>qba_20240301235959000001</pos_seq>
<sys_seq>0741136885a748c1</sys_seq>
<trans_time>20240301151515</trans_time>
<verify_id>qba_20240301151515000001</verify_id>
<result>
<id>0000</id>
<comment>申请成功</comment>
</result>
</business_trans>
交易返回报文说明
标准接口会因业务升级需要而新增节点,请在解析返回报文时避免新增未知节点产生的程序出错!
节点名称 | 中文名称 | 类型 | 说明 | 是否必填 |
---|---|---|---|---|
sign | 报文签名 | String(32) | 返回报文格式为JSON时必填 计算签名方式请看2.1章节 | 可选 |
response_type | 返回类型 | String(32) | 固定值:online_quickbuckle_apply_response | 必填 |
isspid | 商户号 | String(8) | 翼码商户号,由翼码提供 | 必填 |
pos_id | 终端号 | String(20) | 商户自定义终端号 | 必填 |
pos_seq | 绑卡申请流水号 | String(32) | 绑卡申请流水号,和请求报文相同 | 必填 |
sys_seq | 随机串号 | String(16) | 随机生成串号,仅用于日志跟踪用,不保存 | 必填 |
trans_time | 接口返回时间 | String(14) | 接口返回时间,格式:yyyyMMddHHmmss | 必填 |
verify_id | 验卡流水号 | String(64) | 当申请成功时返回,绑卡确认接口需要传入 | 可空 |
result ->id | 响应码 | String(4) | 0000:申请成功 其它表示失败,错误信息说明见“响应码解释”字段 | 必填 |
result ->comment | 响应码解释 | String(64) | 响应码对应中文注解,用于显示提示 | 必填 |
标准接口会因业务升级需要而新增节点,请在解析返回报文时避免新增未知节点产生的程序出错!
常见问题
当快捷绑卡申请返回响应码解释(result->comment)中出现“已超过最大查询次数或操作过于频繁”,表示要素验证连续失败 3 次以上。核实要素确实没有问题,可 24 小时后再发起重试。