数据格式
接口数据格式统一采用以下格式:
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为成功时, 解析本字段 |