银行卡签约列表查询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/list_card.htm

 

请求参数

参数名称

参数

必填 

类型

描述

商户号

platformId

varchar2(40)

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

用户帐号

accountId

varchar2(60)

用户在商户的唯一ID

账号类型

accountType

varchar2(20)

outer

银行卡类型

cardType

varchar2(20)

debit:储蓄卡 credit:信用卡

排序规则sortRulevarchar2(20)

排序规则,目前支持 signTimeDesc:按签约时间降序,chargeTimeDesc:按最近使用时间降序

默认为signTimeDesc

 

返回参数

参数名称

参数

必填

类型

描述

操作返回码

operationResp

varchar2(10)

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

业务返回码

businessResp

varchar2(10)

业务返回码,当操作响应码为 000000 时,解析本字段。

“010000”表示 查询成功; 
  “060001”
表示 用户不存在;

详细消息

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


truefalse

支付方式

payMethod


QUICKPAY

银行卡渠道

channel


支付银行英文名称,BocDebitQuickPay

持卡人姓

cardAccountFirstName


只显示姓

预留手机号后4

mobilePhoneTail


4567

手机号归属地

mobilePhoneAttribution


格式如‘省-’,浙江-杭州

手机运营商

mobileCarrier


格式如‘中国移动’

注:卡信息是名为cardInfos的jsonArray,按照签约时间倒序排列,即最近签约的在前。