银行卡签约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/sign.htm


请求参数

参数名称

参数

必填

类型

描述

商户号

platformId

varchar2(40)

商户号共享签约主平台商户号)。

用户帐号

accountId

varchar2(60)

用户在商户的唯一Id(去除空格)

账号类型

accountType

varchar2(20)

outer,网易内部账号传URS

银行ID

bankId

varchar2(20)

用户要签约银行卡所属银行ID银行ID

银行卡开户姓名

cardAccountName

varchar2(120)

用户银行卡开户姓名

银行卡卡号

cardNo

varchar2(60)

银行卡卡号

银行卡预留手机

mobilePhone

varchar2(20)

银行预留手机

身份证号

certNo

varchar2(30)

身份证号

银行卡有效期

validDate

varchar2(30)

银行卡有效期yyyymm,信用卡需要传

银行卡cvv2

cvv2

varchar2(10)

银行卡cvv2,信用卡需要传

用户IP

userIp

varchar2(20)

用户操作IP,请确定传用户的真实IP,签约时可能会调用公安网进行身份验证

风控信息

riskInfo

varchar2(1024)

风控信息,json格式 商户风控参数表

免验证码直接签约

directlySign

boolean

true,表示免验证码直接签约;默认为false。

开通此功能,无需再调用sign_verfy.htm接口。

 

返回参数

参数名称

参数

必填

类型

描述

操作返回码

operationResp

varchar2(10)

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

业务返回码

businessResp

varchar2(10)

业务相应码, operationResp为成功时,解析本字段

详细消息

detailMsg

varchar2(1024)

返回详情,human-readable

银行卡签约流水号

quickPayId

varchar2(40)

银行卡签约流水号, operationRespbusinessResp为成功时, 解析本字段

银行卡签约附加信息

signAttach

varchar2(60)

银行卡签约附加信息, operationRespbusinessResp为成功时, 解析本字段