交易请求报文

JSON:

  1. {
  2. "request_type": "online_banklist_request",
  3. "isspid": "39493002",
  4. "pos_id": "1511300001",
  5. "store_id": "1511300001",
  6. "pos_seq": "2018121400000004",
  7. "system_id": "8888",
  8. "order_type": "P",
  9. "gate_type": "01",
  10. "sign": "314DA43E7E244105ECBD45F797264854"
  11. }

XML:

  1. <?xml version="1.0" encoding="GBK"?>
  2. <business_trans>
  3. <request_type>online_banklist_request</request_type>
  4. <isspid>39493002</isspid>
  5. <pos_id>1511300001</pos_id>
  6. <store_id>1511300001</store_id>
  7. <pos_seq>1511300000002</pos_seq>
  8. <system_id>8888</system_id>
  9. <order_type>P</order_type>
  10. <gate_type>01</gate_type>
  11. </business_trans>

交易请求报文说明

节点名称中文名称类型说明是否必填
sign报文签名String(32)请求报文格式为JSON时必填
计算签名方式请看2.1章节
可空
request_type请求类型String(32)固定值:online_banklist_request必填
isspid商户号String(8)翼码商户号,由翼码提供必填
pos_id终端号String(20)商户自定义终端号必填
store_id门店号String(20)商户自定义门店号必填
pos_seq请求流水号String(32)非交易接口不做校验,仅用于日志查询可空
system_id系统平台号String(4)由翼码提供必填
order_type订单类型String(1)P:支付
R:充值
必填
gate_type网关支付类型String(2)01:个人网关
02:企业网关
必填

交易返回报文

JSON:

  1. {
  2. "response_type": "online_banklist_response",
  3. "isspid": "39493002",
  4. "pos_id": "6666666666",
  5. "pos_seq": "2018121400000004",
  6. "trans_time": "20181214143516",
  7. "sys_seq": "0741136885a748c1",
  8. "b2b_list": "[]",
  9. "b2c_c_list": "[{\"bank_id\":\"00000001\",\"bank_name\":\"杭州银行\",\"bank_short_chn\":\"杭州银行\",\"bank_short_eng\":\"CIB\",\"card_type\":\"C\"}]",
  10. "b2c_d_list": "[{\"bank_id\":\"00000001\",\"bank_name\":\"中国银行\",\"bank_short_chn\":\"中国银行\",\"bank_short_eng\":\"CIB\",\"card_type\":\"D\"},{\"bank_id\":\"01040000\",\"bank_name\":\"中国银行\",\"bank_short_chn\":\"中国银行\",\"bank_short_eng\":\"BOC\",\"card_type\":\"D\"}]",
  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_banklist_response</response_type>
  4. <isspid>39493002</isspid>
  5. <pos_id>1511300001</pos_id>
  6. <pos_seq>1511300000002</pos_seq>
  7. <sys_seq>0311095321465179</sys_seq>
  8. <trans_time>20160311095321</trans_time>
  9. <b2b_list><![CDATA[b2b银行列表(JSONArray)]]></b2b_list>
  10. <b2c_c_list><![CDATA[b2c贷记卡银行列表(JSONArray)]]></b2c_c_list>
  11. <b2c_d_list><![CDATA[b2c借记卡银行列表(JSONArray)]]></b2c_d_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_banklist_response必填
isspid商户号String(8)翼码商户号,由翼码提供必填
pos_id终端号String(20)商户自定义终端号必填
pos_seq请求流水号String(32)和请求报文相同可空
sys_seq随机串号String(16)随机生成串号,仅用于日志跟踪用,不保存必填
trans_time接口返回时间String(14)接口返回时间,格式:yyyyMMddHHmmss必填
b2b_listb2b银行列表StringJSONArray格式
当使用XML报文接入时,使用CDATA标签包裹内容
可空
b2c_c_listb2c贷记卡银行列表StringJSONArray格式
当使用XML报文接入时,使用CDATA标签包裹内容
可空
b2c_d_listb2c借记卡银行列表StringJSONArray格式
当使用XML报文接入时,使用CDATA标签包裹内容
可空
result
->id
响应码String(4)0000:查询成功
其它表示失败,错误信息说明见“响应码解释”字段
必填
result
->comment
响应码解释String(64)响应码对应中文注解,用于显示提示必填

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

b2b_list b2b银行列表

JSON节点类型说明是否必填范例
bank_idString(8)银行编码可空00000001
bank_nameString(256)银行名称可空杭州银行
bank_short_chnString(256)银行中文简称可空杭州银行
bank_short_engString(256)银行英文简称可空CIB
card_typeString(1)卡类型
D:借记卡
C:信用卡
Z:借贷合一卡
可空D

b2c_c_list b2c贷记卡银行列表

JSON节点类型说明是否必填范例
bank_idString(8)银行编码可空00000001
bank_nameString(256)银行名称可空杭州银行
bank_short_chnString(256)银行中文简称可空杭州银行
bank_short_engString(256)银行英文简称可空CIB
card_typeString(1)卡类型
D:借记卡
C:信用卡
Z:借贷合一卡
可空D

b2c_d_list b2c借记卡银行列表

JSON节点类型说明是否必填范例
bank_idString(8)银行编码可空00000001
bank_nameString(256)银行名称可空杭州银行
bank_short_chnString(256)银行中文简称可空杭州银行
bank_short_engString(256)银行英文简称可空CIB
card_typeString(1)卡类型
D:借记卡
C:信用卡
Z:借贷合一卡
可空D