数据格式
接口数据格式统一采用以下格式:
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/list_card.htm
请求参数
参数名称 | 参数 | 必填 | 类型 | 描述 |
商户号 | platformId | 是 | varchar2(40) | 商户号(共享平台请用主平台商户号) |
用户帐号 | accountId | 是 | varchar2(60) | 用户在商户的唯一ID |
账号类型 | accountType | 是 | varchar2(20) | 传outer |
银行卡类型 | cardType | 否 | varchar2(20) | debit:储蓄卡 credit:信用卡 |
排序规则 | sortRule | 否 | varchar2(20) | 排序规则,目前支持 signTimeDesc:按签约时间降序,chargeTimeDesc:按最近使用时间降序 默认为signTimeDesc |
返回参数
参数名称 | 参数 | 必填 | 类型 | 描述 |
操作返回码 | operationResp | 是 | varchar2(10) | 操作响应码,本次调用是否成功 |
业务返回码 | businessResp | 否 | varchar2(10) | 业务返回码,当操作响应码为 000000 时,解析本字段。 “010000”表示 查询成功; |
详细消息 | detailMsg | 否 | varchar2(1024) | 返回详情,human-readable |
签约流水 | quickPayId | 是 | varchar2(40) | 签约流水 |
银行卡卡号后四位 | cardNoTail | 是 | varchar2(20) | 银行卡卡号后四位 |
银行卡类型 | cardType | 是 | varchar2(20) | debit:储蓄卡 credit:信用卡 |
银行ID | bankId | 是 | varchar2(10) | 银行ID(参考附件1) |
银行名称 | bankName | 是 | varchar2(40) | 银行中文名称 |
签约ip | createIp | 是 | varchar2(20) | 签约ip,如127.0.0.1 |
快捷签约时间 | bindTime | 是 | varchar2(24) | 快捷签约时间,如2016-08-30 10:18:23.334 |
卡首次签约时间 | cardFirstBindTime | 是 | varchar2(24) | 银行卡首次签约时间,如2016-08-30 10:18:23.334 |
是否维护中 | maintain | 是 | varchar2(20) | 维护中表示暂时不可用 |
维护开始时间 | maintainStartTime | 否 | varchar2(20) | 维护开始时间,如2016-11-11 20:20:30 |
维护结束时间 | maintainEndTime | 否 | varchar2(20) | 维护结束时间,如 2016-11-14 10:20:30 |
单笔交易限额 | quotaPerOrder | 否 | varchar2(20) | |
单日交易限额 | quotaPerDay | 否 | varchar2(20) | |
手机号 | maskMobile | 是 | varchar2(20) | 隐藏中间4位的手机号,如123****4567 |
卡信息是否完整 | cardComplete | 是 | true或false | |
支付方式 | payMethod | 是 | QUICKPAY | |
银行卡渠道 | channel | 是 | 支付银行英文名称,如BocDebitQuickPay | |
持卡人姓 | cardAccountFirstName | 是 | 只显示姓 | |
预留手机号后4位 | mobilePhoneTail | 是 | 4567 | |
手机号归属地 | mobilePhoneAttribution | 是 | 格式如‘省-市’,如‘浙江-杭州’ | |
手机运营商 | mobileCarrier | 是 | 格式如‘中国移动’ |
注:卡信息是名为cardInfos的jsonArray,按照签约时间倒序排列,即最近签约的在前。