银行卡支付验证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/order_pay_verify.htm

 

请求参数

参数名称

参数

必填

类型

描述

商户号

platformId

varchar2(40)

商户号

调用方平台商户号

callerPlatformId

varchar2(40)

共享签约主平台商户号

用户帐号

accountId

varchar2(60)

用户在商户的唯一Id

账号类型

accountType

varchar2(20)

outer

支付方式

payMethod

varchar2(40)

quickpay:

订单号

orderId

varchar2(40)

订单号, 上一步返回参数

短信验证码

authCode

varchar2(10)

短信验证码

银行卡签约流水

quickPayId

varchar2(40)

银行卡签约流水号为上一步返回参数。

银行卡首次签约并支付时才有这个字段,如果非首次签约,该字段不需要传。

充值流水

chargeId

varchar2(40)

充值流水号为上一步返回参数。若没有quickPayId chargeId 一定要传(银行卡非首次签约并支付需要传)

充值金额

chargeAmount

varchar2(1024)

如果有quickpayId,没有chargeId, 同时bizTypecharge时,充值金额必须有

附加信息

attach

varchar2(60)

附加信息, 银行卡支付时,上一步返回

用户IP

userIp

varchar2(20)

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

风控信息

riskInfo

varchar2(1024)

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

 

注意:

如果是已经签约成功的卡,调用该接口,那么chargeId 一定需要有;quickpayid 是未成功的,那就必须要有chargeAmount 

 

返回参数

参数名称

参数

必填

类型

描述

操作返回码

operationResp

varchar2(10)

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

业务返回码

businessResp

varchar2(10)

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

详细消息

detailMsg

varchar2(1024)

返回详情,human-readable

订单号

orderId

varchar2(40)

订单号,当operationRespbusinessResp为成功时,
 
解析本字段

支付状态

payStatus

varchar2(40)

当前支付请求的支付状态,当operationResp为成功、 支付方式为银行卡支付且不是首次签约时,解析本字段。

字段值包含SUCCESS(代表成功)FAILED(代表失败)PROCESSING(代表处理中)三种状态。 若是签约场景则不支付订单,不需要判断本字段

注:当对一笔已经成功的订单进行支付时,PayStatus返回的结果是失败,代表本次支付行为是失败的。

签约状态

signStatus

varchar2(40)

当前签约同时完成支付请求的签约状态,当operationResp为成功、 支付方式为银行卡支付且是首次签约时,解析本字段。

字段值包含SUCCESS(代表成功)FAILED(代表失败)PROCESSING(代表处理中)三种状态。

注:当对一笔已经签约成功的快捷进行签约同时完成支付请求时,signStatus返回的结果是成功,代表本次签约行为是成功的。