聚鑫-绑定提现银行卡

最近更新时间:2020-02-28 14:25:40

1. 接口描述

接口请求域名: cpdp.tencentcloudapi.com 。

商户绑定提现银行卡,每个商户只能绑定一张提现银行卡

默认接口请求频率限制:20次/秒。

2. 输入参数

以下请求参数列表仅列出了接口请求参数和部分公共参数,完整公共参数列表见 公共请求参数

参数名称 必选 类型 描述
Action String 公共参数,本接口取值:BindAcct。
Version String 公共参数,本接口取值:2019-08-20。
Region String 公共参数,详见产品支持的 地域列表
MidasAppId String 聚鑫分配的支付主MidasAppId
SubAppId String 聚鑫计费SubAppId,代表子商户
BindType Integer 1 – 小额转账验证
2 – 短信验证
每个结算账户每天只能使用一次小额转账验证
SettleAcctNo String 用于提现
<敏感信息>加密详见《商户端接口敏感信息加密说明》
SettleAcctName String 结算账户户名
<敏感信息>加密详见《商户端接口敏感信息加密说明》
SettleAcctType Integer 1 – 本行账户
2 – 他行账户
IdType String 证件类型,见《证件类型》表
IdCode String 证件号码
<敏感信息>加密详见《商户端接口敏感信息加密说明》
AcctBranchName String 开户行名称
MidasSecretId String 聚鑫分配的安全ID
MidasSignature String 按照聚鑫安全密钥计算的签名
Mobile String 用于短信验证
BindType==2时必填
<敏感信息>加密详见《商户端接口敏感信息加密说明》
CnapsBranchId String 超级网银行号和大小额行号
二选一
EiconBankBranchId String 超级网银行号和大小额行号
二选一

3. 输出参数

参数名称 类型 描述
RequestId String 唯一请求 ID,每次请求都会返回。定位问题时需要提供该次请求的 RequestId。

4. 示例

示例1 绑定银行卡请求示例

用于子商户绑定提现银行卡场景。

输入示例

https://cpdp.tencentcloudapi.com/?Action=BindAcct
&<公共请求参数>
&MidasAppId=your_midas_app_id
&SubAppId=your_sub_app_id
&BindType=1
&SettleAcctNo=encrypted_account_no
&SettleAcctName=encrypted_account_name
&SettleAcctType=1
&Mobile=encrypted_mobile_no
&IdType=1
&IdCode=encrypted_id_code
&AcctBranchName=银行名称
&EiconBankBranchId=分行ID
&MidasSecretId=your_midas_secret_id
&MidasSignature=your_midas_signature

输出示例

{
  "Response": {
    "RequestId": "4899ec78-5374-4ab4-bc0c-d758126c77b1"
  }
}

5. 开发者资源

API Explorer

该工具提供了在线调用、签名验证、SDK 代码生成和快速检索接口等能力,能显著降低使用云 API 的难度,推荐使用。

SDK

云 API 3.0 提供了配套的开发工具集(SDK),支持多种编程语言,能更方便的调用 API。

命令行工具

6. 错误码

以下仅列出了接口业务逻辑相关的错误码,其他错误码详见 公共错误码

错误码 描述
FailedOperation.BankFailed 调用银行接口失败,可能原因: 银行接口超时或为获取到返回值 银行接口返回非法
FailedOperation.ServiceError 接口执行失败
FailedOperation.Unknown 未知错误
InvalidParameter 参数错误
MissingParameter. 参数缺失