业务说明
应用场景
持卡人在商户端填写银行短信验证码,完成绑卡确认。收到绑卡成功应答后,商户保存持卡人用户号(user_yima_id)和绑卡序列号(card_token_no)。
交易请求报文
JSON:
{"request_type": "online_quickbuckle_confirm_request","isspid": "39493002","pos_id": "0001","store_id": "0001","pos_seq": "qbc_20240301235959000001","org_pos_seq": "qba_20240301235959000001","verify_id": "qba_20240301235959000001","user_id": "user01","system_id": "8888","mch_name": "翼码科技","mch_cust_id": "U0000001","card_no": "620000000000000000001","card_name": "张三","cert_id": "350102000000000001","card_mp": "18600000001","verify_code": "010101","vip_code": "618","expiration": "0426","dc_type": "C","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_confirm_request</request_type><isspid>39493002</isspid><pos_id>0001</pos_id><store_id>0001</store_id><pos_seq>qbc_20240301235959000001</pos_seq><org_pos_seq>qba_20240301235959000001</org_pos_seq><verify_id>qba_20240301235959000001</verify_id><user_id>user01</user_id><system_id>8888</system_id><mch_name>翼码科技</mch_name><mch_cust_id>U0000001</mch_cust_id><card_no>620000000000000000001</card_no><card_name>张三</card_name><cert_id>350102000000000001</cert_id><card_mp>18600000001</card_mp><verify_code>010101</verify_code><vip_code>618</vip_code><expiration>0426</expiration><dc_type>C</dc_type><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_confirm_request | 必填 |
| isspid | 商户号 | String(8) | 翼码商户号,由翼码提供 | 必填 |
| pos_id | 终端号 | String(20) | 商户自定义终端号 | 必填 |
| store_id | 门店号 | String(20) | 商户自定义门店号 | 必填 |
| pos_seq | 绑卡确认流水号 | String(32) | 可空,若传值则同一个翼码商户号下唯一,不可重复使用,且大于12位 | 可空 |
| org_pos_seq | 绑卡申请流水号 | String(32) | 被确认的绑卡申请流水号,且大于12位 对应【快捷绑卡申请】请求节点中的pos_seq | 必填 |
| verify_id | 验卡流水号 | String(64) | 对应【快捷绑卡申请】返回节点中的verify_id | 必填 |
| user_id | 操作员标识 | String(20) | 操作员号 | 可空 |
| system_id | 系统平台号 | String(4) | 由翼码提供 | 必填 |
| mch_name | 商户名称 | String(128) | 可空 | |
| mch_cust_id | 商户用户id | String(64) | 用户在商户侧生成的用户号 同一用户不要反复生成不同的用户id | 必填 |
| card_no | 银行卡号 | String(64) | 必填 | |
| card_name | 银行卡开户姓名 | String(64) | 必填 | |
| cert_id | 银行卡绑定身份证号 | String(64) | 必填 | |
| card_mp | 银行卡绑定手机号 | String(11) | 11位数字,不包括+86等信息 | 必填 |
| verify_code | 手机验证码 | String(6) | 6位数字 | 必填 |
| vip_code | CVV2安全码 | String(3) | 信用卡交易必填 | 可选 |
| expiration | 卡有效期 | String(4) | 格式:MMYY 信用卡交易必填 | 可选 |
| dc_type | 卡的借贷类型 | String(1) | C:信用卡 D:借记卡 S:准贷记 U:未知卡 | 可空 |
| 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_confirm_response","isspid": "39493002","pos_id": "0001","pos_seq": "qbc_20240301151515000001","trans_time": "20240301151515","sys_seq": "0741136885a748c1","user_yima_id": "6666000103803532","mch_cust_id": "U0000001","card_token_no": "10000093623","result": {"id": "0000","comment": "绑卡成功"},"sign": "F6106656C20AB23B547B0C30DD819793"}
XML:
<?xml version="1.0" encoding="GBK"?><business_trans><response_type>online_quickbuckle_confirm_response</response_type><isspid>39493002</isspid><pos_id>0001</pos_id><pos_seq>qbc_20240301235959000001</pos_seq><sys_seq>0741136885a748c1</sys_seq><trans_time>20240301151515</trans_time><user_yima_id>6666000103803532</user_yima_id><mch_cust_id>U0000001</mch_cust_id><card_token_no>10000093623</card_token_no><result><id>0000</id><comment>绑卡成功</comment></result></business_trans>
交易返回报文说明
标准接口会因业务升级需要而新增节点,请在解析返回报文时避免新增未知节点产生的程序出错!
| 节点名称 | 中文名称 | 类型 | 说明 | 是否必填 |
|---|---|---|---|---|
| sign | 报文签名 | String(32) | 返回报文格式为JSON时必填 计算签名方式请看2.1章节 | 可选 |
| response_type | 返回类型 | String(32) | 固定值:online_quickbuckle_confirm_response | 必填 |
| isspid | 商户号 | String(8) | 翼码商户号,由翼码提供 | 必填 |
| pos_id | 终端号 | String(20) | 商户自定义终端号 | 必填 |
| pos_seq | 绑卡确认流水号 | String(32) | 绑卡确认流水号,和请求报文相同 | 必填 |
| sys_seq | 随机串号 | String(16) | 随机生成串号,仅用于日志跟踪用,不保存 | 必填 |
| trans_time | 接口返回时间 | String(14) | 接口返回时间,格式:yyyyMMddHHmmss | 必填 |
| user_yima_id | 持卡人用户号 | String(32) | 翼码系统的用户号 绑卡成功时必填 | 可空 |
| mch_cust_id | 商户用户id | String(64) | 和请求报文相同 绑卡成功时必填 | 可空 |
| card_token_no | 绑卡序列号 | String(64) | 绑卡序列号 绑卡成功时必填 | 可空 |
| result ->id | 响应码 | String(4) | 0000:绑卡成功 其它表示失败,错误信息说明见“响应码解释”字段 | 必填 |
| result ->comment | 响应码解释 | String(64) | 响应码对应中文注解,用于显示提示 | 必填 |
标准接口会因业务升级需要而新增节点,请在解析返回报文时避免新增未知节点产生的程序出错!


