交易请求报文
JSON:
{
"request_type": "online_banklist_request",
"isspid": "39493002",
"pos_id": "1511300001",
"store_id": "1511300001",
"pos_seq": "2018121400000004",
"system_id": "8888",
"order_type": "P",
"gate_type": "01",
"sign": "314DA43E7E244105ECBD45F797264854"
}
XML:
<?xml version="1.0" encoding="GBK"?>
<business_trans>
<request_type>online_banklist_request</request_type>
<isspid>39493002</isspid>
<pos_id>1511300001</pos_id>
<store_id>1511300001</store_id>
<pos_seq>1511300000002</pos_seq>
<system_id>8888</system_id>
<order_type>P</order_type>
<gate_type>01</gate_type>
</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:
{
"response_type": "online_banklist_response",
"isspid": "39493002",
"pos_id": "6666666666",
"pos_seq": "2018121400000004",
"trans_time": "20181214143516",
"sys_seq": "0741136885a748c1",
"b2b_list": "[]",
"b2c_c_list": "[{\"bank_id\":\"00000001\",\"bank_name\":\"杭州银行\",\"bank_short_chn\":\"杭州银行\",\"bank_short_eng\":\"CIB\",\"card_type\":\"C\"}]",
"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\"}]",
"result": {
"id": "0000",
"comment": "查询成功"
},
"sign": "F6106656C20AB23B547B0C30DD819793"
}
XML:
<?xml version="1.0" encoding="GBK"?>
<business_trans>
<response_type>online_banklist_response</response_type>
<isspid>39493002</isspid>
<pos_id>1511300001</pos_id>
<pos_seq>1511300000002</pos_seq>
<sys_seq>0311095321465179</sys_seq>
<trans_time>20160311095321</trans_time>
<b2b_list><![CDATA[b2b银行列表(JSONArray)]]></b2b_list>
<b2c_c_list><![CDATA[b2c贷记卡银行列表(JSONArray)]]></b2c_c_list>
<b2c_d_list><![CDATA[b2c借记卡银行列表(JSONArray)]]></b2c_d_list>
<result>
<id>0000</id>
<comment>查询成功</comment>
</result>
</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_list | b2b银行列表 | String | JSONArray格式 当使用XML报文接入时,使用CDATA标签包裹内容 | 可空 |
b2c_c_list | b2c贷记卡银行列表 | String | JSONArray格式 当使用XML报文接入时,使用CDATA标签包裹内容 | 可空 |
b2c_d_list | b2c借记卡银行列表 | String | JSONArray格式 当使用XML报文接入时,使用CDATA标签包裹内容 | 可空 |
result ->id | 响应码 | String(4) | 0000:查询成功 其它表示失败,错误信息说明见“响应码解释”字段 | 必填 |
result ->comment | 响应码解释 | String(64) | 响应码对应中文注解,用于显示提示 | 必填 |
标准接口会因业务升级需要而新增节点,请在解析返回报文时避免新增未知节点产生的程序出错!
b2b_list b2b银行列表
JSON节点 | 类型 | 说明 | 是否必填 | 范例 |
---|---|---|---|---|
bank_id | String(8) | 银行编码 | 可空 | 00000001 |
bank_name | String(256) | 银行名称 | 可空 | 杭州银行 |
bank_short_chn | String(256) | 银行中文简称 | 可空 | 杭州银行 |
bank_short_eng | String(256) | 银行英文简称 | 可空 | CIB |
card_type | String(1) | 卡类型 D:借记卡 C:信用卡 Z:借贷合一卡 | 可空 | D |
b2c_c_list b2c贷记卡银行列表
JSON节点 | 类型 | 说明 | 是否必填 | 范例 |
---|---|---|---|---|
bank_id | String(8) | 银行编码 | 可空 | 00000001 |
bank_name | String(256) | 银行名称 | 可空 | 杭州银行 |
bank_short_chn | String(256) | 银行中文简称 | 可空 | 杭州银行 |
bank_short_eng | String(256) | 银行英文简称 | 可空 | CIB |
card_type | String(1) | 卡类型 D:借记卡 C:信用卡 Z:借贷合一卡 | 可空 | D |
b2c_d_list b2c借记卡银行列表
JSON节点 | 类型 | 说明 | 是否必填 | 范例 |
---|---|---|---|---|
bank_id | String(8) | 银行编码 | 可空 | 00000001 |
bank_name | String(256) | 银行名称 | 可空 | 杭州银行 |
bank_short_chn | String(256) | 银行中文简称 | 可空 | 杭州银行 |
bank_short_eng | String(256) | 银行英文简称 | 可空 | CIB |
card_type | String(1) | 卡类型 D:借记卡 C:信用卡 Z:借贷合一卡 | 可空 | D |