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 在交易对手方的金融机构（FI）处登记一个 Cobre Balance 账户。
在此过程中，金融机构会通知交易对手方并请求其授权，以允许对其账户执行扣款操作。

登记为异步流程，最终状态取决于金融机构和交易对手方的响应。

Direct Debit 登记状态

以下为交易对手方 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 登记可执行的操作#

通过 Direct Debit 收款

关键术语

Direct Debit Registration API

Direct Debit 登记状态

Direct Debit 登记状态

Cobre Direct Debit 使用体验

登记类型

快速开始

使用此 API 前

使用此 API 后的预期结果

Direct Debit 登记可执行的操作