业务说明

应用场景

支持快捷支付绑卡申请。上送持卡人四要素信息(银行卡、户名、证件号、银行留存手机号)进行验证,验证成功后银行会向持卡人的银行留存手机号发送短信验证码。

交易请求报文

JSON:

  1. {
  2. "request_type": "online_quickbuckle_apply_request",
  3. "isspid": "39493002",
  4. "pos_id": "0001",
  5. "store_id": "0001",
  6. "pos_seq": "qba_20240301235959000001",
  7. "user_id": "user01",
  8. "system_id": "8888",
  9. "mch_name": "翼码科技",
  10. "mch_cust_id": "U0000001",
  11. "email": "1@qq.com",
  12. "card_no": "620000000000000000001",
  13. "card_name": "张三",
  14. "cert_id": "350102000000000001",
  15. "cert_validity_type": "0",
  16. "cert_begin_date": "20220618",
  17. "cert_end_date": "20420618",
  18. "card_mp": "18600000001",
  19. "vip_code": "618",
  20. "expiration": "0426",
  21. "dc_type": "C",
  22. "protocol_no": "34463343",
  23. "device_ip": "127.0.0.1",
  24. "device_type": "4",
  25. "device_mac": "0C-96-E6-84-1E-11",
  26. "device_imei": "460030912121001",
  27. "device_imsi": "460030912121001",
  28. "device_icc_id": "898600680113F0123014",
  29. "device_wifi_mac": "96-87-78-69-5A-4B",
  30. "latitude": "+37.12",
  31. "longitude": "-121.213",
  32. "sign": "314DA43E7E244105ECBD45F797264854"
  33. }

XML:

  1. <?xml version="1.0" encoding="GBK"?>
  2. <business_trans>
  3. <request_type>online_quickbuckle_apply_request</request_type>
  4. <isspid>39493002</isspid>
  5. <pos_id>0001</pos_id>
  6. <store_id>0001</store_id>
  7. <pos_seq>qba_20240301235959000001</pos_seq>
  8. <user_id>user01</user_id>
  9. <system_id>8888</system_id>
  10. <mch_name>翼码科技</mch_name>
  11. <mch_cust_id>U0000001</mch_cust_id>
  12. <email>1@qq.com</email>
  13. <card_no>620000000000000000001</card_no>
  14. <card_name>张三</card_name>
  15. <cert_id>350102000000000001</cert_id>
  16. <cert_validity_type>0</cert_validity_type>
  17. <cert_begin_date>20220618</cert_begin_date>
  18. <cert_end_date>20420618</cert_end_date>
  19. <card_mp>18600000001</card_mp>
  20. <vip_code>618</vip_code>
  21. <expiration>0426</expiration>
  22. <dc_type>C</dc_type>
  23. <protocol_no>34463343</protocol_no>
  24. <device_ip>127.0.0.1</device_ip>
  25. <device_type>4</device_type>
  26. <device_mac>0C-96-E6-84-1E-11</device_mac>
  27. <device_imei>460030912121001</device_imei>
  28. <device_imsi>460030912121001</device_imsi>
  29. <device_icc_id>898600680113F0123014</device_icc_id>
  30. <device_wifi_mac>96-87-78-69-5A-4B</device_wifi_mac>
  31. <latitude>+37.12</latitude>
  32. <longitude>-121.213</longitude>
  33. </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商户用户idString(64)用户在商户侧生成的用户号
同一用户不要反复生成不同的用户id
必填
email电子邮箱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_codeCVV2安全码String(3)信用卡交易必填可选
expiration卡有效期String(4)格式:MMYY
信用卡交易必填
可选
dc_type卡的借贷类型String(1)C:信用卡
D:借记卡
S:准贷记
U:未知卡
可空
protocol_no挂网协议编号String(32)招行绑卡必填
招行固定填写值:34463343
可选
device_ip设备IPString(15)设备所在的公网IP,可用于定位所属地区
不是wifi连接时的局域网IP
IPV4格式
必填
device_type设备类型String(1)1:手机
2:平板
3:手表
4:PC
必填
device_mac设备终端的物理地址String(64)必填
device_imei交易设备IMEIString(64)移动终端设备的唯一标识必填
device_imsi交易设备IMSIString(64)必填
device_icc_id交易设备ICCIDString(64)必填
device_wifi_mac交易设备WIFIMACString(64)必填
latitude纬度String(9)交易设备的经纬度信息
纬度格式:+表示北纬,-表示南纬;纬度整数位不超过2位,小数位不超过6位。
必填
longitude经度String(9)交易设备的经纬度信息
经度格式:+表示东经,-表示西经;经度整数位不超过3位,小数位不超过5位。
必填

自定义门店号(store_id)和自定义终端号(pos_id)需经过4.1终端绑定交易接口绑定成功过的值才可以调用,绑定一次即可不需要重复绑定。

交易返回报文

JSON:

  1. {
  2. "response_type": "online_quickbuckle_apply_response",
  3. "isspid": "39493002",
  4. "pos_id": "0001",
  5. "pos_seq": "qba_20240301151515000001",
  6. "sys_seq": "0741136885a748c1",
  7. "trans_time": "20240301151515",
  8. "verify_id": "qba_20240301151515000001",
  9. "result": {
  10. "id": "0000",
  11. "comment": "申请成功"
  12. },
  13. "sign": "F6106656C20AB23B547B0C30DD819793"
  14. }

XML:

  1. <?xml version="1.0" encoding="GBK"?>
  2. <business_trans>
  3. <response_type>online_quickbuckle_apply_response</response_type>
  4. <isspid>39493002</isspid>
  5. <pos_id>0001</pos_id>
  6. <pos_seq>qba_20240301235959000001</pos_seq>
  7. <sys_seq>0741136885a748c1</sys_seq>
  8. <trans_time>20240301151515</trans_time>
  9. <verify_id>qba_20240301151515000001</verify_id>
  10. <result>
  11. <id>0000</id>
  12. <comment>申请成功</comment>
  13. </result>
  14. </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 小时后再发起重试。