绑卡

功能概述

本接口用于协议支付银行卡绑定。

接口地址

https://apis.5upay.com/cashier/bindcard/submit

参数名称 参数中文名称 类型& 长度 参数说明 是否必填
merchantId 商户编号 varchar(9) 商户在首信易系统的唯一id,可在商户后台查看 M
merchantUserId 商户会员id varchar(32) 可通过传入此参数进行绑卡,每个商户下面唯一,请给每个用户分配一个id用于传入此参数,以便用户下次支付时可用之前绑定过的卡,此项请务必保存 M
phoneNumber 预留⼿机号 varchar(15) 用户银行卡预留手机号 M
bankCardNumber 银行卡号 varchar(50) 用户银行卡卡号 M
name 持卡⼈姓名 varchar(20) 用户银行卡姓名 M
idCardNum 身份证号 varchar(50) 用户身份证号 M
bindCardCallbackUrl 回调地址 varchar(200) 传入格式如: “https://www.5upay.com/callback.action?test=test”.绑卡完成以后会跳转此链接 C
bindCardNotifyUrl 通知地址 varchar(200) 服务器通知:当订单状态为终态后会向该地址发送通知,该地址可以带参数,如: “https://www.5upay.com/callback.a ction?test=test”.注意:如不填 notifyUrl 的参数值支付成功后您的服 务器将得不到绑卡成功的通知。 C
partnerId 服务商id varchar(9) 服务商在首信易系统的唯一id,可在商户后台查看 C
hmac 参数签名 varchar(500) 商户生成的参数签名结果,获取hmac的方法请参考请求加密流程 M

以上参数值中不能包含以下特殊字符’”&<>()

参数示例

{ "hmac": null, "merchantId": "100000050", "merchantUserId ": "1234", "phoneNumber ": "13211111111", "bankCardNumber ": "6214830111111111", "name ": "张三", "idCardNum ": "130229199409093353" }

请求同步返回参数列表

参数名称 参数中文名称 参数说明
merchantId 商户编号 同请求参数
partnerId 服务商Id 同请求参数
merchantUserId 商户会员id 同请求参数
bankCardNumber 银行卡号 同请求参数
name 持卡人姓名 同请求参数
status 状态 SUCCESS 成功(请求成功而不是绑卡成功)
REDIRECT 重定向(返回此状态后需要跳转此参数列表中的绑卡重定向地址,后续不需要再进行调用绑卡确认接口)
ERROR 错误
errorMsg 错误信息 错误信息
bindCardRedirectUrl 绑卡重定向地址 当status为REDIRECT,跳转此地址进行绑卡
bindCardId 绑卡id 绑卡同步请求成功后返回的绑卡id
bindStatus 银行卡绑定状态 INIT 初始化
PROCESS 处理中(调用此接口后出现此状态继续调用绑卡确认接口)
FAIL 失败
cardType 银行卡类型 DEBIT_CARD 借记卡
CREDIT_CARD 信用卡
bankCode 银行编码 见编码表.xlsx
hmac 参数签名 首信易生成的参数签名结果,验签过程请参考解密流程

参数示例

{ "merchantId": "100000050", "merchantUserId": "1234", "bankCardNumber": "6214830111111111", "name": "张三", "status": "SUCCESS", "bindCardId": "12345678", "bindStatus": " PROCESS", "cardType": "DEBIT_CARD", "bankCode": " BOC", "hmac": null }

请求异步返回参数列表

参数名称 参数中文名称 参数说明
merchantId 商户编号 同请求参数
partnerId 服务商Id 同请求参数
merchantUserId 商户会员id 同请求参数
bankCardNumber 银⾏卡号 用户绑定银行卡号
name 持卡⼈姓名 用户银行卡姓名
errorMsg 错误信息 错误信息
bindCardId 绑卡id 绑卡请求成功后返回的绑卡id,此参数用于调用绑卡查询和下单时接口的bindCardId参数。
bindStatus 银⾏卡绑定状态 FAIL 失败
SUCCESS 成功
UNBIND 已解绑
DISABLE 不可用
cardType 银⾏卡类型 DEBIT_CARD 借记卡
CREDIT_CARD 信用卡
bankCode 银⾏编码 见编码表.xlsx

参数示例

{ "merchantId": "100000050", "merchantUserId": "1234", "bankCardNumber": "6214830111111111", "name": "张三", "bindCardId": "959e138ad2e290328e8d59fd124c618f ", "bindStatus": " SUCCESS", "cardType": "DEBIT_CARD", "bankCode": " CCB", "hmac": null }