创建收款人
- 创建提现银行卡API只有子商户才可以使用。主商户需要在Portal上创建。
- 不同国家、货币和下发方式所需的数据采集字段各有差异。收款人模板下载 (opens new window)
- 当收款人为
个人时，账户名(account_name)为first_name+last_name组成。- 当付款方式为
Swift或者币种为IDR或US-USD时，province和city都必须是必填字段。
- 美国允许的列表：美国州 (opens new window)
- 印度尼西亚允许的列表：印尼省 (opens new window),印尼城市 (opens new window)
- 其他国家，应该根据实际数据传递省和市的值。
如果当前收款人被拒绝后，无法继续创建时，需要使用 编辑收款人接口 (opens new window)进行修改，也可以使用 删除收款人接口 (opens new window)进行删除后，再次创建。
# 重点参数
| 参数名 | 说明 |
|---|---|
| partner_payee_id | 商户唯一ID。如果输入重复的ID，会返回当前ID对应的收款人信息。 |
| payee_type | 收款人类型。提现银行卡(BeneficiaryBankAccount)、收款人(SupplierBankAccount)、电子钱包(E-Wallet)。 |
| payment_method | 下发方式。银行卡需要指定Local或者Swift。电子钱包需要指定钱包类型。 |
| contact_documents | 创建收款人(SupplierBankAccount)时需要提供证明您和收款人具体业务关系的商业关系材料。 |
| reference | 创建提现银行卡(BeneficiaryBankAccount)时需要银行证明或银行交易流水单据。 |
| payee_info | 收款人信息。 |
| bank_account_info | 银行卡信息。创建提现银行卡(BeneficiaryBankAccount)或收款人(SupplierBankAccount)时必填。 |
| wallet_info | 电子钱包信息。创建电子钱包(E-Wallet)时必填。 |
创建收款人的第一个状态一定是待审核(Pending)，当审核成功(Approved)或失败(Declined)时，我们将会通过webhook进行 异步通知 (opens new window)。
# 常见问题
- 收款人是根据哪个字段判断不能重复的？
卡号、币种、支付方式、收款人类型、银行名称、SWIFT Code、Routing Type 和 Routing Value 组合形成唯一标识。
# 收款人模板
以下模板可能会不定期进行更新。更多模板请参考收款人模板下载 (opens new window)
# Swift
- payment_method: Swift
- routing_type1: Swift
- 支持币种：USD，CAD，EUR，JPY，GBP，AUD，CNH，HKD
# Company
| 参数名 | 描述 | 是否必填 |
|---|---|---|
| company_name | 输入内容不能包含中文 | M |
| bank_name | 输入内容不能包含中文 | M |
| account_no | 请输入3~33位的英文,数字【不可输入空格，特殊符号等】，Sepa国家填写iban，Clabe国家填写Clabe | M |
| iban | 向Sepa清算网络的国家支付任何币种都填写 | C |
| clabe | 向Clabe清算网络的国家支付任何币种都填写 | C |
| swift_code | 请按照银行代码格式填写 | M |
| routing_value1 | US-USD必填（Fedwire路由号请输入9位的数字【不可输入英文、空格、特殊符号等】） | C |
| account_name | 输入内容不能包含中文 | M |
| street_address | 输入内容不能包含中文 | M |
| city | 收款人所在城市，必填输入内容不能包含中文 | C |
| post_code | payee_country为US必填，币种为USD，EUR，GBP，AUD输入内容不能包含中文 | C |
| province | payee_country为US必填，币种为USD，EUR，GBP，AUD输入内容不能包含中文 | C |
| payee_country | 收款人所在国家 | M |
| contact_documents | 请提供证明您和收款人具体业务关系的商业关系材料：如您和收款人之间盖有公章的合作协议等材料。 | M |
# Personal
| 参数名 | 描述 | 是否必填 |
|---|---|---|
| first_name | 输入内容不能包含中文 | M |
| last_name | 输入内容不能包含中文 | M |
| bank_name | 输入内容不能包含中文 | M |
| account_no | 请输入3~33位的英文,数字【不可输入空格，特殊符号等】，Sepa国家填写iban，Clabe国家填写Clabe | M |
| iban | 向Sepa清算网络的国家支付任何币种都填写 | C |
| clabe | 向Clabe清算网络的国家支付任何币种都填写 | C |
| swift_code | 请按照银行代码格式填写 | M |
| routing_value1 | US收款人填Fedwire路由号请输入9位的数字【不可输入英文、空格、特殊符号等】 | M |
| account_name | 输入内容不能包含中文 | M |
| street_address | 输入内容不能包含中文 | M |
| city | 收款人所在城市，输入内容不能包含中文 | C |
| post_code | payee_country为US必填，币种为USD，EUR，GBP，AUD输入内容不能包含中文 | C |
| province | payee_country为US必填，币种为USD，EUR，GBP，AUD输入内容不能包含中文 | C |
| payee_country | 收款人所在国家 | M |
| contact_documents | 请提供证明您和收款人具体业务关系的商业关系材料：如您和收款人之间盖有公章的合作协议等材料。 | M |
# Local-US
- payment_method: Local
- routing_type1: Fedwire
- 支持币种：USD
# Company
| 参数名 | 描述 | 是否必填 |
|---|---|---|
| company_name | 输入内容不能包含中文 | M |
| bank_name | 输入内容不能包含中文 | M |
| account_no | 请输入3~33位的英文,数字【不可输入空格，特殊符号等】 | M |
| swift_code | 请按照银行代码格式填写 | M |
| routing_value1 | FedWire路由号，请输入9位的数字【不可输入英文、空格、特殊符号等】 | M |
| account_name | 输入内容不能包含中文 | M |
| street_address | 输入内容不能包含中文 | M |
| city | 输入内容不能包含中文 | M |
| post_code | 收款人城市邮编，输入内容不能包含中文 | M |
| province | 收款人所在州，输入内容不能包含中文 | M |
| payee_country | 收款人所在国家 | M |
| contact_documents | 请提供证明您和收款人具体业务关系的商业关系材料：如您和收款人之间盖有公章的合作协议等材料。 | M |
# Personal
| 参数名 | 描述 | 是否必填 |
|---|---|---|
| first_name | 输入内容不能包含中文 | M |
| lastName | 输入内容不能包含中文 | M |
| bank_name | 输入内容不能包含中文 | M |
| account_no | 请输入3~33位的英文,数字【不可输入空格，特殊符号等】 | M |
| swift_code | 请按照银行代码格式填写 | M |
| routing_value1 | FeiWire路由号请输入9位的数字【不可输入英文、空格、特殊符号等】 | M |
| account_name | 输入内容不能包含中文 | M |
| street_address | 输入内容不能包含中文 | M |
| city | 输入内容不能包含中文 | M |
| post_code | 收款人邮编，输入内容不能包含中文 | M |
| province | 收款人所在州，输入内容不能包含中文 | M |
| payee_country | 收款人所在国家 | M |
| contact_documents | 请提供证明您和收款人具体业务关系的商业关系材料：如您和收款人之间盖有公章的合作协议等材料。 | M |
# Local-HK
- payment_method: Local
- routing_type1: FPS, RTGS
- 支持币种：HKD, USD
# Company-HKD-FPS
| 参数名 | 描述 | 是否必填 |
|---|---|---|
| company_name | 输入内容不能包含中文 | M |
| bank_name | 银行名称 枚举值 | M |
| account_no | 输入内容不能包含中文 | M |
| bank_code | 银行编号 | M |
| branch_code | 支行号 | M |
| account_name | 输入内容不能包含中文 | M |
| phone | 收款人联系方式 | M |
| street_address | 输入内容不能包含中文 | M |
| payeeCountry | 收款人所在国家 | M |
| contact_documents | 请提供证明您和收款人具体业务关系的商业关系材料：如您和收款人之间盖有公章的合作协议等材料。 | M |
# Personal-HKD-FPS
| 参数名 | 描述 | 是否必填 |
|---|---|---|
| first_name | 输入内容不能包含中文 | M |
| last_name | 输入内容不能包含中文 | M |
| bank_name | 银行名称 枚举值 | M |
| account_no | 输入内容不能包含中文 | M |
| bank_code | 银行编号 | M |
| branch_code | 支行号 | M |
| account_name | 输入内容不能包含中文 | M |
| phone | 收款人联系方式 | M |
| street_address | 输入内容不能包含中文 | M |
| payee_country | 收款人所在国家 | M |
| contact_documents | 请提供证明您和收款人具体业务关系的商业关系材料：如您和收款人之间盖有公章的合作协议等材料。 | M |
# Company-HKD-RTGS
| 参数名 | 描述 | 是否必填 |
|---|---|---|
| company_name | 输入内容不能包含中文 | M |
| bank_name | 银行名称 枚举值 | M |
| account_no | 输入内容不能包含中文 | M |
| swift_code | 请按照银行代码格式填写 | M |
| account_name | 输入内容不能包含中文 | M |
| street_address | 输入内容不能包含中文 | M |
| city | 输入内容不能包含中文 | M |
| post_code | 输入内容不能包含中文 | M |
| province | 输入内容不能包含中文 | M |
| payee_country | 收款人所在国家 | M |
| contact_documents | 请提供证明您和收款人具体业务关系的商业关系材料：如您和收款人之间盖有公章的合作协议等材料。 | M |
# Personal-HKD-RTGS
| 参数名 | 描述 | 是否必填 |
|---|---|---|
| first_name | 输入内容不能包含中文 | M |
| last_name | 输入内容不能包含中文 | M |
| bank_name | 银行名称 枚举值 | M |
| account_no | 输入内容不能包含中文 | M |
| swift_code | 请按照银行代码格式填写 | M |
| account_name | 输入内容不能包含中文 | M |
| street_address | 输入内容不能包含中文 | M |
| city | 输入内容不能包含中文 | M |
| post_code | 输入内容不能包含中文 | M |
| province | 输入内容不能包含中文 | M |
| payee_country | 收款人所在国家 | M |
| contact_documents | 请提供证明您和收款人具体业务关系的商业关系材料：如您和收款人之间盖有公章的合作协议等材料。 | M |
# Company-USD-RTGS
| 参数名 | 描述 | 是否必填 |
|---|---|---|
| company_name | 输入内容不能包含中文 | M |
| bank_name | 输入内容不能包含中文 | M |
| account_no | 请输入3~33位的英文,数字【不可输入空格，特殊符号等】 | M |
| swift_code | 请按照银行代码格式填写 | M |
| account_name | 输入内容不能包含中文 | M |
| street_address | 输入内容不能包含中文 | M |
| city | 输入内容不能包含中文 | M |
| payee_country | 收款人所在国家 | M |
| contact_documents | 请提供证明您和收款人具体业务关系的商业关系材料：如您和收款人之间盖有公章的合作协议等材料。 | M |
# Personal-USD-RTGS
| 参数名 | 描述 | 是否必填 |
|---|---|---|
| first_name | 输入内容不能包含中文 | M |
| last_name | 输入内容不能包含中文 | M |
| bank_name | 输入内容不能包含中文 | M |
| account_no | 请输入3~33位的英文,数字【不可输入空格，特殊符号等】 | M |
| swift_code | 请按照银行代码格式填写 | M |
| account_name | 输入内容不能包含中文 | M |
| street_address | 输入内容不能包含中文 | M |
| city | 输入内容不能包含中文 | M |
| payee_country | 收款人所在国家 | M |
| contact_documents | 请提供证明您和收款人具体业务关系的商业关系材料：如您和收款人之间盖有公章的合作协议等材料。 | M |
# Local-SEPA
- payment_method: Local
- routing_type1: SEPA
- 支持币种：EUR
# Company
| 参数名 | 描述 | 是否必填 |
|---|---|---|
| company_name | 输入内容不能包含中文 | M |
| bank_name | 输入内容不能包含中文 | M |
| account_no | Iban | M |
| swift_code | 请按照银行代码格式填写 | M |
| account_name | 输入内容不能包含中文 | M |
| street_address | 收款人地址输入内容不能包含中文 | M |
| city | 收款人所在城市 | M |
| payee_country | 收款人所在国家 | M |
| contact_documents | 请提供证明您和收款人具体业务关系的商业关系材料：如您和收款人之间盖有公章的合作协议等材料。 | M |
# Personal
| 参数名 | 描述 | 是否必填 |
|---|---|---|
| first_name | 输入内容不能包含中文 | M |
| last_name | 输入内容不能包含中文 | M |
| bank_name | 输入内容不能包含中文 | M |
| account_no | Iban | M |
| swift_code | 请按照银行代码格式填写 | M |
| account_name | 输入内容不能包含中文 | M |
| street_address | 输入内容不能包含中文 | M |
| city | 输入内容不能包含中文 | M |
| payee_country | 收款人所在国家 | M |
| contact_documents | 请提供证明您和收款人具体业务关系的商业关系材料：如您和收款人之间盖有公章的合作协议等材料。 | M |