Transfer-In

Transfer-In API 提供创建和查询由 Cobre 分配的 Transfer-In 账户参考的服务。

Transfer-In 账户参考是由 Cobre 通过其金融机构合作伙伴开通的真实银行账号。它允许付款方使用标准银行转账信息向该账户参考汇入资金，从而实现自动化收款，无需人工对账。

Transfer-In 账户参考可作为可复用的收款账户，通常被企业用于接收 B2B 银行转账，资金将自动入账至关联的 Cobre Balance。您最多可以创建 300 个转入账户。

Transfer-In 账户参考没有到期日，因此可以无限次重复使用以接收转入资金。

请联系您的客户经理以启用 Transfer-In

Transfer-In 是一项需要提前开通的功能，开通后方可使用 transfer_acc 参考类型。

支持的组合

创建 Transfer-In 账户参考时，需考虑所支持的账户类型和服务商，详情如下：

Cobre Balance 地区（source_id）	服务商 ID	账户参考类型
Cobre Balance Colombia	`pr_col_1066`	`transfer_acc`

Transfer-In 账户参考生命周期

Transfer-In 账户参考对象通过 connectivity.status 字段追踪其状态。该字段可帮助您：

了解账号何时可以共享给付款方

确认 Coopcentral 是否已成功完成开通请求

Transfer-In 账户参考的状态说明如下：

`connectivity.status`	描述
`processing`	中间状态，表示账户创建请求已提交，服务商正在开通账号，账号暂不可用。
`enabled`	账户参考已成功开通，当前处于激活状态，可接收转账。银行账号及账户类型可在 `metadata` 对象中获取。
`failed`	账户参考创建失败，银行账号不返回。

请注意，Transfer-In 账户参考的创建为异步流程，因此创建请求将始终以 connectivity.status: "processing" 返回。最终状态需通过 GET 接口端点查询，或在参考状态变更为 enabled 或 failed 后通过 Webhook 获取。

Transfer-In 账户参考支持的操作

🔑 Create

🔍 Retrieval

❌ Delete an Account Reference

描述： 创建 Transfer-In 账户参考。
操作后预期结果： 创建的账户参考状态为 connectivity.status: "processing"，并由服务商异步开通。激活后，银行账号可在 metadata 对象中获取。
📘 了解更多：

🔗 创建 Transfer-In 账户参考

错误码

错误码	描述
`REF000`	参考创建失败，请重试。
`REF001`	参考创建失败。`{source_id}` 对应的服务商对该参考类型无效，请选择有效服务商的账户后重试。
`REF002`	参考创建失败。参考类型无效，请输入有效的参考类型后重试。
`REF006`	参考创建失败。`{source_id}` 不属于发起请求的客户，请使用正确客户名下的账户发起请求后重试。
`REF008`	参考创建失败。您尝试创建的账户参考类型关联的功能已被禁用，请联系您的客户经理启用该功能后重试。
`REF009`	参考创建失败。您尝试用于创建参考的服务商未启用，请使用有效的 `provider_id` 发起请求后重试。
`REF010`	参考创建失败。账户 `{source_id}` 未处于激活状态，请选择已激活的账户后重试。

如何开始

在开始之前，建议您先了解以下注意事项。

使用本 API 前

Contact your KAM to enable Transfer-In

在使用 transfer_acc 参考类型之前，必须先为您的账户启用 Transfer-In 功能。

You need an active Cobre Balance in Colombia

创建 Transfer-In 账户参考需要拥有一个激活状态的 Cobre Balance Colombia 账户（pr_col_cobre 服务商）。

Define your collection model

在创建账户参考之前，请考虑如何设计您的收款流程。您可以为每位付款方创建独立的账户参考以实现精确归因，也可以使用单一账户参考收取多位付款方的款项。

Implement Webhooks to track account reference status and incoming transfers

为实时掌握 Transfer-In 账户参考的生命周期变化并在收到资金时获得通知，我们强烈建议您实现 Webhooks。Webhooks 可在账户参考开通完成以及转账入账至您的 Cobre Balance 时实时通知您的系统。请订阅 accounts.balance.credit 事件以接收交易通知，并订阅 transfer_acc.status.processing、transfer_acc.status.enabled 和 transfer_acc.status.failed 事件以跟踪账户创建进度。

详情请参阅通知与订阅。

使用本 API 后的预期结果

Share the bank account details with your payer

账户参考状态变更为 enabled 后，请从 value 字段获取银行账号，从 metadata.account_type 获取账户类型，从 metadata.provider_id 获取所属银行，从 metadata.account_holder_Id 获取账户持有人 NIT，并将上述信息提供给付款方，以便其从任意哥伦比亚金融机构发起转账。

请参阅为您的账户参考生成证明文件

Start receiving transfers

付款方向指定账号发起银行转账后，Cobre 将自动检测到该入账转账，并将资金自动入账至关联的 Cobre Balance。您将在与该参考关联的 Cobre Balance 账户中看到一笔 transfer_credit 类型的交易记录。可通过 Webhooks 或 GET 接口端点获取交易信息。

Reconcile incoming payments

每笔 transfer_credit 交易记录均包含付款方税务 ID、付款方名称、付款方银行、转账日期以及接收资金的账户参考信息，为您的财务团队提供准确对账所需的全部数据。

Transfer-In

支持的组合#

Transfer-In 账户参考生命周期#

Transfer-In 账户参考支持的操作#

错误码#

如何开始#

使用本 API 前#

使用本 API 后的预期结果#

支持的组合

Transfer-In 账户参考生命周期

Transfer-In 账户参考支持的操作

错误码

如何开始

使用本 API 前

使用本 API 后的预期结果