业务说明

应用场景

商户调用该接口，获取持卡人绑卡结果，以及持卡人用户号(user_yima_id)和银行卡绑卡序列号(card_token_no)用于发起快捷交易。

交易请求报文

JSON:

  1. {
  2.     "request_type": "online_quickbuckle_query_request",
  3.     "isspid": "39493002",
  4.     "pos_id": "0001",
  5.     "store_id": "0001",
  6.     "pos_seq": "qbq_20240301235959000001",
  7.     "system_id": "8888",
  8.     "mch_cust_id": "U0000001",
  9.     "sign": "314DA43E7E244105ECBD45F797264854"
  10. }

XML:

  1. <?xml version="1.0" encoding="GBK"?>
  2. <business_trans>
  3.     <request_type>online_quickbuckle_query_request</request_type>
  4.     <isspid>39493002</isspid>
  5.     <pos_id>0001</pos_id>
  6.     <store_id>0001</store_id>
  7.     <pos_seq>qbq_20240301235959000001</pos_seq>
  8.     <system_id>8888</system_id>
  9.     <mch_cust_id>U0000001</mch_cust_id>
  10. </business_trans>

交易请求报文说明

节点名称中文名称类型说明是否必填
sign报文签名String(32)请求报文格式为JSON时必填
计算签名方式请看2.1章节		可空
request_type请求类型String(32)固定值：online_quickbuckle_query_request必填
isspid商户号String(8)翼码商户号，由翼码提供必填
pos_id终端号String(20)商户自定义终端号必填
store_id门店号String(20)商户自定义门店号必填
pos_seq绑卡查询流水号String(32)可空，若传值则同一个翼码商户号下唯一，不可重复使用，且大于12位可空
system_id系统平台号String(4)由翼码提供必填
mch_cust_id商户用户idString(64)对应【快捷绑卡确认】返回节点中的mch_cust_id必填

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

交易返回报文

JSON:

  1. {
  2.     "response_type": "online_quickbuckle_query_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_list": "[{\"card_token_no\":\"10000093623\",\"card_no\":\"620000000000000000001\",\"card_name\":\"张三\"},{\"card_token_no\":\"10000093624\",\"card_no\":\"620000000000000000002\",\"card_name\":\"张三\"}]",
  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_query_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_list><![CDATA[[{"card_token_no":"10000093623","card_no":"620000000000000000001","card_name":"张三"},{"card_token_no":"10000093624","card_no":"620000000000000000002","card_name":"张三"}]]]></card_list>
  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_query_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_list卡列表StringJSONArray格式
当使用XML报文接入时，使用CDATA标签包裹内容		可空
result
->id		响应码String(4)0000：查询成功
其它表示失败，错误信息说明见“响应码解释”字段		必填
result
->comment		响应码解释String(64)响应码对应中文注解，用于显示提示必填

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

card_list 卡列表

JSON节点类型说明是否必填范例
card_token_noString(20)绑卡序列号必填10000093623
card_noString(64)银行卡号必填620000000000000000001
card_nameString(64)银行卡开户姓名必填张三