获取可用银行网关API

数据格式

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

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

接口公共参数msg和sign的值说明如下:

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

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

1)计算m的32位md5值,得到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为网关类型,value为List列表(可多值,包含以下内容)

--- 银行网关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为该网关类型对应的可用网关,是一个多值列表。