数据格式
接口数据格式统一采用以下格式:
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; |
返回参数
参数名称 | 参数 | 必填 | 类型 | 描述 |
操作返回码 | 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为该网关类型对应的可用网关,是一个多值列表。