业务说明
应用场景
持卡人在商户端填写银行短信验证码,完成绑卡确认。收到绑卡成功应答后,商户保存持卡人用户号(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) | 响应码对应中文注解,用于显示提示 | 必填 |
标准接口会因业务升级需要而新增节点,请在解析返回报文时避免新增未知节点产生的程序出错!