2.2 账户卡管理

2.2.1 发起绑卡

【场景介绍】

用户账户可以绑定银行卡（信用卡或借记卡），以便实现充值、提现、转账、绑卡支付等操作。

【重要说明】根据相关法规要求，用户的银行卡信息需要第三方支付机构收集，所以用户的该操作需要在钱麦页面完成，故需要商户端发起用户账户绑卡的请求，且在用户操作完成之后，钱麦将结果同步\/异步反馈给商户，返回商户端页面。

【调用流程】

【请求地址】

环境	接口服务URI
生产环境	`/rest/v1.0/user/bindCard`

\/****请求参数和返回参数同2.1.2发起实名认证

2.2.1.1请求参数

参数名称	参数含义	数据类型	必填	参数说明
requestNo	商户请求号	String(32)	Y
merchantNo	商户编号	String(16)	Y
merchantUserId	商户用户标识	String(32)	Y
webCallbackUrl	页面回调地址	String(512)	Y	实名完成后返回商户的地址
returnUrl	返回地址	String(512)	Y	钱麦第一个H5页面左上角点“返回”的回退地址
clientSource	设备来源	Enum	N	MOBILE--移动端（不传默认此项）

2.2.1.2返回参数

参数名称	参数定义	参数说明
redirectUrl	重定向地址	跳转到钱麦实名页面的地址
code	返回码	请参考附录：返回码列表
message	返回消息	返回码的详细说明

2.2.2解绑卡

【场景介绍】

用户将已绑定的银行卡解除与账户的绑定关系，该操作可以由用户在商户端发起请求。

【重要说明】由于解绑卡操作涉及到支付账户，故需要验证支付密码以确认操作人的身份。验证支付密码的请求由商户端发起，用户需要在钱麦的页面输入支付密码进行身份校验，钱麦将校验结果同步\/异步反馈给商户，且在用户输入支付密码之后，返回商户端页面，商户继续处理用户的其他请求。

【调用流程】

【请求地址】

	接口服务URI
生产环境	`/rest/v1.0/user/unbindCard`

2.2.2.1请求参数

参数名称	参数含义	数据类型	必填	参数说明
requestNo	商户请求号	String(32)	Y
merchantNo	商户编号	String(16)	Y
merchantUserId	商户用户标识	String(32)	Y
bindId	需要解绑的绑卡ID	String(32)	Y
reason	解绑卡原因	String(128)	Y
token	密码验证结果	String（32）	Y	发起转账前需要调用密码校验接口获取验密token

2.2.2.2返回参数

参数名称	参数定义	参数说明
code	返回码	请参考附录：返回码列表
message	返回信息	返回码的详细说明

2.2.3绑卡列表查询

【场景介绍】

用于查询该用户下所有所绑定的银行卡列表信息。

【调用流程】

【请求地址】

环境	接口服务URI
生产环境	`/rest/v1.0/user/queryBindCardList`

2.2.3.1请求参数

参数名称	参数含义	数据类型	必填	参数说明
merchantNo	商户编号	String(16)	Y
merchantUserId	商户用户标识	String(32)	Y

2.2.3.2返回参数

参数名称	参数定义	参数说明
cardList	绑卡列表	详见下文绑卡列表注释说明
code	返回码	请参考附录：返回码列表
message	返回信息	返回码的详细说明

1、返回格式：Json串；

2、返回示例：

[ {

"bindId" : "2020895",

"cardNo" : "621226*********2076",

"bankName" : "工商银行",

"bankCode" : "ICBC",

"cardType" : "DEBITCARD",

"mobilePhone" : "138****8888"

}, {

"bindId" : "2030881",

"cardNo" : "621492******1040",

"bankName" : "光大银行",

"bankCode" : "CEB",

"cardType" : "DEBITCARD",

"mobilePhone" : "138****8888"

} ]

即

[ {

"绑卡ID" : "2020895",

"卡号" : "621226*********2076",

"银行名称" : "工商银行",

"银行编码" : "ICBC",

"银行卡类型" : "DEBITCARD",

"银行预留手机号" : "138****8888"

}, {

"绑卡ID" : "2030881",

"卡号" : "621492******1040",

"银行名称" : "光大银行",

"银行编码" : "CEB",

"银行卡类型" : "DEBITCARD",

"银行预留手机号" : "138****8888"

} ]

2.2.4余额查询（用户）

【场景介绍】

用户查询资金账户中的余额情况。

【调用流程】

【请求地址】

环境	接口服务URI
生产环境	`/rest/v1.0/user/queryUserBalance`

2.2.4.1请求参数

参数名称	参数含义	数据类型	必填	参数说明
merchantNo	商户编号	String(16)	Y
merchantUserId	商户用户标识	String(32)	Y

2.2.4.2返回参数

参数名称	参数定义	参数说明
balance	用户余额	单位：元，用户余额=可用余额+冻结余额
availableAmount	可用余额	单位：元
freezeAmount	冻结金额	单位：元
code	返回码	请参考附录：返回码列表
message	返回信息	返回码的详细说明

2.2.5绑卡列表查询页面

【场景介绍】

用于PC端用户查询已绑定银行卡信息，也可以在这个页面上进行绑卡和解绑卡操作。

【调用流程】

【请求地址】

环境	接口服务URI
生产环境	`/rest/v1.0/user/getBindCardListPage`

2.2.5.1请求参数

参数名称	参数含义	数据类型	必填	参数说明
requestNo	商户请求号	String(32)	Y
merchantNo	商户编号	String(16)	Y
merchantUserId	商户用户标识	String(32)	Y
webCallbackUrl	页面回调地址	String(512)	Y	实名完成后返回商户的地址
returnUrl	返回地址	String(512)	Y	钱脉第一个H5页面左上角点“返回”的回退地址
clientSource	设备来源	Enum	Y	PC—PC端

2.2.5.2返回参数

参数名称	参数定义	参数说明
redirectUrl	重定向地址	跳转到钱脉绑卡列表页面的地址
code	返回码	请参考附录：返回码列表
message	返回消息	返回码的详细说明

2.2 账户卡管理