业务说明
应用场景
支持快捷支付绑卡申请。上送持卡人四要素信息(银行卡、户名、证件号、银行留存手机号)进行验证,验证成功后银行会向持卡人的银行留存手机号发送短信验证码。
交易请求报文
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 小时后再发起重试。


