获取可用银行网关API

数据格式

接口数据格式统一采用以下格式:

https://domain/path?msg=&sign=

接口公共参数msgsign的值说明如下:

msg为所有参数base64编码后的值,为方便后续说明此处将base64编码后的msg值记为m

sign的值s在得到m之后经过2个步骤计算得到:

1)计算m32md5值,得到32位大写字符串m1;

2)使用数字证书签名方式计算m1的签名,得到s。


接口地址

https://epay.163.com/pay_api/v1/query_bank_gate.htm

 

请求参数

参数名称

参数

必填

类型

描述

商户号

platformId

varchar2(40)

商户号(共享签约请用主平台商户号)

网关类型

gateType

varchar2(30)

多值,用|分隔,如  1|2|5|6|7
  1
:网银储蓄卡;
  2
:网银信用卡;
  6
:快捷储蓄卡;
  7
:快捷信用卡;
  24
WAP网银储蓄卡;
  12
WAP网银信用卡;
  5
:企业储蓄卡;
  19
:银联认证支付;
  20
:银联储蓄卡支付;
  21
:银联移动支付;

 

返回参数

参数名称

参数

必填

类型

描述

操作返回码

operationResp

varchar2(10)

操作响应码,本次调用是否成功

详细消息

detailMsg

varchar2(1024)

返回详情,human-readable

可用网关列表

banks

varchar2(20)

可用网关列表,存放多个Map,其中key为网关类型,valueList列表(可多值,包含以下内容)

--- 银行网关ID

bankId

varchar2(20)

银行网关ID

--- 银行样式ID

bankStyleId

varchar2(20)

用于前端获取展示图片

--- 银行名字

bankName

varchar2(20)

如:工商银行

--- 银行类型

bankType

varchar2(20)

企业银行为"company",   其他都为空

--- 银行卡类型

cardType

varchar2(20)

储蓄卡或信用卡,值为 debit/credit

--- 当前网关是否可用

enable

varchar2(20)

true表示网关可用,false表示不可用,商户通过此值判断网关是否可用

--- 是否维护中

maintain

varchar2(20)

维持中表示暂时不可用

--- 维护开始时间

maintainStartTime

varchar2(20)


--- 维护结束时间

maintainEndTime

varchar2(20)


--- 单笔交易限额

quotaPerOrder

varchar2(20)


--- 单日交易限额

quotaPerDay

varchar2(20)


--- 是否支持 签约并支付

signAndPay

varchar2(20)

“true” or   "false"

--- 是否支持 提现

supportWithdraw

varchar2(20)

“true” or   "false"

--- 优惠信息

promotion

varchar2(20)


--- 备注

tips

varchar2(20)


注意:请求中的gateType指定哪几种网关类型,返回的结果中每个MAP中会分别以传入的网关类型作为KEY,value为该网关类型对应的可用网关,是一个多值列表。