Transfer-In

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

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

Transfer-In 账户引用可作为可复用的收款账户，通常供企业接收 B2B 银行转账，资金将自动入账至关联的 Cobre Balance。

Transfer-In 账户引用没有到期日，因此可根据需要多次使用以接收转入资金。

请联系您的客户经理（KAM）以启用 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`	引用创建失败。您尝试创建的账户引用类型关联的功能已被禁用，请联系您的客户经理（KAM）开启该功能后重试。
`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 事件以获取账户创建进度更新。

请参阅 Notifications & Subscriptions 了解更多详情。

使用此 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 后的预期结果