银行卡签约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/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)

银行卡签约流水号, 当operationResp、businessResp为成功时, 解析本字段

银行卡签约附加信息

signAttach

否

varchar2(60)

银行卡签约附加信息, 当operationResp、businessResp为成功时, 解析本字段