Direct Debit

通过 Direct Debit 收款

Direct Debit Registration API（DDR） 允许 Cobre 客户在其金融机构注册交易对手方，从而授权对该交易对手方的账户执行直接扣款操作。

注册完成并经交易对手方批准后，客户可通过 Money Movements API 向已注册的交易对手方发起 direct_debit 资金划转。

Direct Debit 可实现自动化收款，无需交易对手方手动发起转账。

关键术语

DDR（Direct Debit Registration，直接扣款注册）： 用于注册并授权交易对手方账户以允许扣款的流程。

Nequi： 提供小额存款和储蓄账户、并支持直接扣款操作的金融机构。

Direct Debit Registration API

Direct Debit Registration API 用于将 Cobre Balance 账户 在交易对手方的金融机构（FI）进行注册。
在此过程中，金融机构将通知交易对手方，并请求其授权对账户执行扣款操作。

注册为异步处理，最终状态取决于金融机构及交易对手方的响应。

Direct Debit 注册状态

以下为交易对手方直接扣款注册请求可能获得的各种状态。

状态	描述
Processing	表示注册请求正在处理中，金融机构将通知交易对手方并请求其确认。
Registered	表示交易对手方已成功完成直接扣款注册。
Unregistered	表示交易对手方未获授权执行直接扣款操作。

Direct Debit 注册状态详情

状态	状态码	描述
Registered	NA	注册已成功完成。
Unregistered	DR000	无法创建账户注册，请稍后重试。
Unregistered	DR002	账户注册请求失败。交易对手方 $counterparty$ 不允许进行账户注册。请确认该交易对手方的地区和类型是否满足账户注册所需条件。
Unregistered	DR003	账户注册请求失败。所提供的描述超过最大长度限制，请提供有效描述后重试。
Unregistered	DR004	账户注册请求失败。注册类型无效，请输入有效的注册类型后重试。
Unregistered	DR005	账户注册失败。该交易对手方类型或其 beneficiary_institution 不适用于 ddr_nequi 类型的注册。请确认交易对手方具有有效类型及正确的 beneficiary_institution 后重试。
Unregistered	DR006	账户注册失败。该交易对手方已有一笔注册请求正在处理中，请等待当前注册完成后再重试。
Unregistered	DR007	账户注册失败。该交易对手方的 Direct Debit 注册次数已超过上限（30 次），请使用新的交易对手方重试。

Cobre Direct Debit 使用流程

注册交易对手方，并指定所需的注册类型（例如 nequi）。

Registration confirmation

交易对手方须通过其金融机构批准注册。

Create a Direct Debit money movement

当交易对手方状态变为 registered 后，通过 Money Movements API 创建 direct_debit 资金划转。

Funds reception

一笔 dd_credit 交易将被记入与直接扣款关联的 Cobre Balance 账户。

并非所有金融机构都允许用户拒绝注册，但大多数机构会在其账户完成注册时通知交易对手方。
如果某交易对手方已在不同类型下多次注册，将使用最新的注册记录。

注册类型

	Nequi Direct Debit
描述	允许通过 Nequi（金融机构代码：1507）注册交易对手方并进行扣款
预计注册时间	用户批准最长需 15 分钟
用户确认方式	须通过 Nequi 应用完成
扣款处理时间	实时
支持的金融机构	Nequi

使用入门

使用此 API 前的准备工作

Create a counterparty

创建类型为 CC、CH 或 DP 的交易对手方。

通过 Direct Debit Registration 接口端点注册交易对手方。

Subscribe to required events

订阅事件，以接收有关注册状态变更、资金划转及收款的通知。

每个交易对手方必须与待扣款账户单独完成注册。

使用此 API 后的预期结果

Registration status update

注册状态将流转至 registered、unregistered 或 failed。

Perform Direct Debit money movements

若交易对手方状态为 registered，即可发起 direct_debit 资金划转。

Receive funds

资金划转状态变为 completed 后，一笔 dd_credit 交易将记入 Cobre Balance 账户。

Direct Debit 注册可执行操作

🔑 Create

🔍 Retrieval

描述： 为交易对手方注册 Direct Debit。
预期结果： 将创建一个 Direct Debit Registration 对象并进行异步处理。
📘 了解更多：

🔗 为交易对手方注册 Direct Debit

Direct Debit

通过 Direct Debit 收款#

关键术语#

Direct Debit Registration API#

Direct Debit 注册状态#

Direct Debit 注册状态详情#

Cobre Direct Debit 使用流程#

注册类型#

使用入门#

使用此 API 前的准备工作#

使用此 API 后的预期结果#

Direct Debit 注册可执行操作#