创建收款人
- 不同国家、货币和下发方式所需的数据采集字段各有差异。收款人模板下载 (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 组合形成唯一标识。
# 收款人模板
收款人模版可能会根据不同银行的要求会不定期进行更新。