新增收款卡
需要验证签名
接口描述
该接口支持人民币和外币到账银行卡号添加。同时支持提现（收款银行账户和KYC主体同名）业务和付款（收款账户和KYC主体非同名）业务。 受理请求后，异步执行卡信息验证，新增审核结果以异步方式回调通知（建议长时间未接收到回调通知通过查询收款卡接口获取结果信息）。
提示
- 发起提现前，先创建收款卡，并通过审核。
- 同一币种的相同卡号只能调用本接口一次，审核失败后需根据失败原因调用更新接口提交材料审核。
请求头
| Parameter | Type | Required | Description |
|---|---|---|---|
| Authorization | string | M | access_token |
| Content-Type | string | M | application/json |
请求参数
| Parameter | Type | Required | Description |
|---|---|---|---|
| client_id | string(64) | M | 客户号 |
| pay_type | enum | M | 卡使用场景类型, WITHDRAW(提现), PAY(付款) |
| supplier_type | enum | C | 贸易场景类型,pay_type为付款时必填,点击见附录 |
| id_number | string(64) | C | 银行卡对应的证件号,pay_type为提现时必填，付款时 银行卡地区为：ID,JP,VN,IN,PH,TH,TR,BD,MY,SG,AE,BR时必填 |
| holder_type | enum | M | 账户持有者类型：对私 PERSON（个人）, 对公 ENTERPRISE （企业） |
| account_name | string(255) | M | 银行账户名称（对私账户需与个人姓名⼀致，对公账户需与公司名称⼀致）。 |
| account_type | enum | M | 银行账户类型, 境内：CREDIT(贷记卡), DEBIT(借记卡) 境外：SAVING(储蓄账户), CURRENT(现金账户) |
| bank_code | string(64) | O | 银行编码 |
| bank_name | string(128) | M | 银行名称（国内银行使用中文） |
| branch_code | string(64) | C | 国内支行代码/联行号，holder_type为对公时且卡币种为CNY时必填 |
| branch_name | string(128) | C | 银行支行名称，holder_type为对公时且卡币种为CNY时必填 |
| bank_area | string(2) | M | 银行卡地区,例如US、HK、CN等 |
| bank_address | string(512) | O | 银行地址 |
| account_no | string(64) | M | 银行账户号，欧洲可使用iban |
| currency | string(3) | M | 银行账户币种 |
| swift_code | string(11) | C | 收款行SWIFT代码【国际支付必填，该字段仅支持8位或11位】 |
| routing_no | string(16) | C | 本地银行编码或路由号【如US地区的ABA Code，GB的sort code,HK地区的bank code + branch code等】，外币卡，当无swift code时，必填 |
| receiver_address | string(255) | M | 收款人地址 |
| phone_no | string(11) | O | 客户手机号码,选填 |
| calling_prefix | string(10) | O | 国际电话区号,选填 示例：+86 |
返回响应
| Parameter | Type | Required | Description |
|---|---|---|---|
| card_id | string(64) | M | 添加卡后返回的唯一编号，幂等。可用于后期查询绑定结果和接收回调通知使用 |
返回示例
- 成功
- 失败
{
"code": 200,
"data": {
"card_id": "20220620151628"
},
"message": "SUCCESS"
}
{
"code": 900002,
"data": null,
"message": "参数不合法"
}
错误码
| 返回码 | 描述 | 建议 |
|---|---|---|
| 900000 | system error | 系统错误，请联系PingPong人员核查 |
| 900001 | card has already bind | 卡已被占用，请调用查询接口或审核失败的调用更新接口 |
| 900002 | illegal param | 参数错误，请根据提示更正信息 |
更新日志
2024-04-01 支持付款绑卡
- 新增pay_type字段，必填。
- 新增supplier_type字段，付款类型必填，
- 新增receiver_address 收款人地址字段，必填