2.2 账户卡管理
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 | 返回消息 | 返回码的详细说明 |