业务说明

应用场景

持卡人在商户端填写银行短信验证码,完成绑卡确认。收到绑卡成功应答后,商户保存持卡人用户号(user_yima_id)和绑卡序列号(card_token_no)。

交易请求报文

JSON:

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

XML:

  1. <?xml version="1.0" encoding="GBK"?>
  2. <business_trans>
  3. <request_type>online_quickbuckle_confirm_request</request_type>
  4. <isspid>39493002</isspid>
  5. <pos_id>0001</pos_id>
  6. <store_id>0001</store_id>
  7. <pos_seq>qbc_20240301235959000001</pos_seq>
  8. <org_pos_seq>qba_20240301235959000001</org_pos_seq>
  9. <verify_id>qba_20240301235959000001</verify_id>
  10. <user_id>user01</user_id>
  11. <system_id>8888</system_id>
  12. <mch_name>翼码科技</mch_name>
  13. <mch_cust_id>U0000001</mch_cust_id>
  14. <card_no>620000000000000000001</card_no>
  15. <card_name>张三</card_name>
  16. <cert_id>350102000000000001</cert_id>
  17. <card_mp>18600000001</card_mp>
  18. <verify_code>010101</verify_code>
  19. <vip_code>618</vip_code>
  20. <expiration>0426</expiration>
  21. <dc_type>C</dc_type>
  22. <device_ip>127.0.0.1</device_ip>
  23. <device_type>4</device_type>
  24. <device_mac>0C-96-E6-84-1E-11</device_mac>
  25. <device_imei>460030912121001</device_imei>
  26. <device_imsi>460030912121001</device_imsi>
  27. <device_icc_id>898600680113F0123014</device_icc_id>
  28. <device_wifi_mac>96-87-78-69-5A-4B</device_wifi_mac>
  29. <latitude>+37.12</latitude>
  30. <longitude>-121.213</longitude>
  31. </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商户用户idString(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_codeCVV2安全码String(3)信用卡交易必填可选
expiration卡有效期String(4)格式:MMYY
信用卡交易必填
可选
dc_type卡的借贷类型String(1)C:信用卡
D:借记卡
S:准贷记
U:未知卡
可空
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_confirm_response",
  3. "isspid": "39493002",
  4. "pos_id": "0001",
  5. "pos_seq": "qbc_20240301151515000001",
  6. "trans_time": "20240301151515",
  7. "sys_seq": "0741136885a748c1",
  8. "user_yima_id": "6666000103803532",
  9. "mch_cust_id": "U0000001",
  10. "card_token_no": "10000093623",
  11. "result": {
  12. "id": "0000",
  13. "comment": "绑卡成功"
  14. },
  15. "sign": "F6106656C20AB23B547B0C30DD819793"
  16. }

XML:

  1. <?xml version="1.0" encoding="GBK"?>
  2. <business_trans>
  3. <response_type>online_quickbuckle_confirm_response</response_type>
  4. <isspid>39493002</isspid>
  5. <pos_id>0001</pos_id>
  6. <pos_seq>qbc_20240301235959000001</pos_seq>
  7. <sys_seq>0741136885a748c1</sys_seq>
  8. <trans_time>20240301151515</trans_time>
  9. <user_yima_id>6666000103803532</user_yima_id>
  10. <mch_cust_id>U0000001</mch_cust_id>
  11. <card_token_no>10000093623</card_token_no>
  12. <result>
  13. <id>0000</id>
  14. <comment>绑卡成功</comment>
  15. </result>
  16. </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商户用户idString(64)和请求报文相同
绑卡成功时必填
可空
card_token_no绑卡序列号String(64)绑卡序列号
绑卡成功时必填
可空
result
->id
响应码String(4)0000:绑卡成功
其它表示失败,错误信息说明见“响应码解释”字段
必填
result
->comment
响应码解释String(64)响应码对应中文注解,用于显示提示必填

标准接口会因业务升级需要而新增节点,请在解析返回报文时避免新增未知节点产生的程序出错!