资金流动审批

Money Movement 审批 API 允许客户在执行前暂停 Money Movement,锁定发起账户中的资金,并在处理付款之前等待审批或拒绝的决定。当客户希望在 Cobre 之外构建自定义的复核制（Maker-Checker）工作流,同时仍依赖 Cobre 来强制执行付款保留并处理最终结果时,通常会使用此功能。

当创建 Money Movement 时设置 checker_approval = true,Cobre 会将该 Money Movement 的状态设为 pending_approval。此时,资金会通过一笔借记交易锁定在发起账户中。一旦客户的外部审批流程做出决定,该决定会被发送回 Cobre,以便 Money Movement 可以继续处理或被取消。

Money Movement 审批的工作原理

Money Movement 审批是从标准的 Money Movement 创建流程中触发的。

在创建过程中激活 checker_approval 标志,即可将 Money Movement 发送去审批。一旦发送审批,审批决定将决定该 Money Movement 是可以被处理还是必须被取消。审批对象包含三个关键概念:决定、说明,以及一个或多个用于可追溯性的审批人。(审批资金流动)

审批结果

结果	发生的情况
已批准	Money Movement 可以继续处理。
已拒绝	Money Movement 被设为取消状态。
待处理	Money Movement 保持等待审批决定的状态。

一个 Money Movement 审批只能被决定一次。(审批资金流动)

审批生命周期

Money Movement 审批遵循一个简单的生命周期:

1. 创建需要审批的 Money Movement

客户创建一个 Money Movement,并通过设置 checker_approval = true 将其标记为需要审批。

此时:

Money Movement 被创建。

状态被设为 pending_approval。

资金被锁定在发起账户中。

一个审批引用与该 Money Movement 相关联。

Money Movement 创建的响应中包含 checker_approval 和 mm_approval_id 等字段,使客户能够识别审批是否已启用,并跟踪关联的审批对象。(审批资金流动)

2. 运行客户的外部审批工作流

审批决定是在 Cobre 之外做出的。

这可能发生在:

ERP 或会计系统中,

财资管理平台中,

内部复核制(Maker-Checker)工作流中,

风险或合规审查流程中,

自定义审批引擎中。

Cobre 不决定是否批准或拒绝该付款。Cobre 会保留该付款,并等待客户提供决定。

3. 将决定发送给 Cobre

一旦外部审批流程做出决定,客户会通过 Money Movement 审批决定机制,将结果发送给 Cobre。

该决定包括:

决定:Money Movement 是被批准还是被拒绝。

说明:该决定的背景或理由。

审批人:参与该决定的一个或多个人员或系统。

包含审批人信息对于可追溯性和可审计性非常重要。文档明确指出,缺少审批人信息是一个常见的错误。(创建资金流动)

4. Cobre 处理或取消 Money Movement

收到决定后:

如果已批准,该 Money Movement 将继续进入标准处理生命周期。

如果已拒绝,该 Money Movement 将被取消。

之后,应像对待任何其他 Money Movement 一样,使用 Money Movement 状态更新、报告或 webhook 通知来跟踪最终执行结果。

功能行为

审批待处理期间资金将被锁定

当 checker_approval = true 时,在 Money Movement 处于 pending_approval 状态期间,Cobre 会通过一笔借记交易将资金锁定在来源账户中。

这确保了:

资金保持为该付款预留,

客户不会意外地对同一余额进行过度分配,

财资系统可以在审批待处理期间将该金额视为已承诺。

审批是外部的,执行由 Cobre 强制执行

客户拥有审批逻辑。Cobre 负责执行结果。

这种分离使客户能够设计自定义的审批流程,同时使用 Cobre 作为执行层。

外部审批规则的示例包括:

按金额阈值审批,

按业务部门审批,

按付款类型审批,

对敏感付款进行双重审批,

执行前的合规审查。

Money Movement 可以通过 API 标记为需要复核审批,并通过 Cobre Portal 的复核审批逻辑进行批准或拒绝。

审批只能发生一次

一旦为某个 Money Movement 审批做出了决定,就不能再次批准。(审批资金流动)

这避免了重复决定,并确保了清晰的审计记录。

审批对象概念

Money Movement 审批由以下业务概念组成:

概念	描述
Money Movement	等待审批的付款指令。
审批 ID	与 Money Movement 关联的审批对象。
决定	最终指令:批准或拒绝。
说明	解释做出该决定原因的背景信息。
审批人	负责审批决定的人员或系统。
状态	审批对象当前的决定状态。

对 Money Movement 审批可执行的操作

✅ 决定

🔍 查询

描述: 针对处于 pending_approval 状态等待中的 Money Movement 发送审批决定。
执行该操作后的预期结果: 如果决定为批准,该 Money Movement 将继续处理。如果决定为拒绝,该 Money Movement 将被取消。
📘 了解更多:

🔗 [审批资金流动

如何开始

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

使用此 API 之前

使用 Money Movement 审批之前

在 Cobre 之外定义你的审批工作流

Money Movement 审批适用于希望在 Cobre 之外运行自己的审批流程的客户,例如在 ERP、财资系统、后台工具或内部复核制(Maker-Checker)工作流中。

Cobre 将保留该 Money Movement 并强制执行最终决定,但客户负责定义由谁审批、何时需要审批,以及适用哪些业务规则。

确保来源账户有足够的资金

当创建 Money Movement 时设置 checker_approval = true,Cobre 会将该 Money Movement 的状态设为 pending_approval,并通过一笔借记交易锁定发起账户中的资金。

请确保在创建该 Money Movement 之前,来源账户拥有足够的可用资金。

创建需要审批的 Money Movement

要将 Money Movement 发送去审批,请求中必须包含 checker_approval = true。

创建后,该 Money Movement 将不会继续处理,直到提供决定为止。

存储 Money Movement 审批引用

创建 Money Movement 后，请存储与该调拨单关联的审批参考号。

外部审批流程完成后，需要使用此参考号发送最终的批准或拒绝决定。

记录审批人信息以便审计

审批决定应包含关于参与该决定的审批人的清晰信息。

这有助于为审计、内部控制、合规审查和运营调查维护可追溯性。

将最终审批决定发送给 Cobre

一旦你的外部工作流做出决定,将结果发送给 Cobre。

如果决定为批准,该 Money Movement 将继续处理。如果决定为拒绝,该 Money Movement 将被取消。

实施 Webhook 或报告以跟踪最终状态

提交审批决定后,该 Money Movement 可能会在达到最终结果之前经历更多的处理状态。

我们强烈建议实施 Webhook 或使用 Money Movement 报告来跟踪该付款是已完成、被拒绝、失败还是被取消。

有关更多详细信息,请参阅通知与订阅。

使用此 API 后的预期结果

Money Movement 在提供决定之前将保持待处理状态

当创建 Money Movement 时设置 checker_approval = true,它将保持 pending_approval 状态,直到向 Cobre 发送批准或拒绝的决定为止。

在等待决定期间,该付款将不会继续处理。

审批待处理期间资金将被锁定

当 Money Movement 进入 pending_approval 状态时,Cobre 会通过一笔借记交易锁定发起账户中的资金。

这确保了在完成外部审批工作流期间,资金始终为该付款保留。

已批准的 Money Movement 将继续处理

如果审批决定为批准,该 Money Movement 将继续通过标准处理生命周期。

批准后,该付款可能仍需经过更多状态,才能达到诸如已完成、被拒绝或失败等最终结果。

被拒绝的 Money Movement 将被取消

如果审批决定为拒绝,该 Money Movement 将被取消,不会被处理。

客户应相应地更新其内部系统,将该拒绝视为该付款的最终业务决定。

审批决定只能提交一次

一个 Money Movement 审批只能收到一次最终决定。

一旦被批准或拒绝,该审批就无法更改或重新提交,这有助于维护清晰的审计记录。

跟踪 Money Movement 的最终状态

提交决定后,请继续跟踪该 Money Movement,直到其达到最终状态。

我们强烈建议使用 Webhook 或 Money Movement 报告来跟踪该付款是已完成、被拒绝、失败还是被取消。

有关更多详细信息,请参阅通知与订阅。

核对审批、Movement 和交易数据

在进行核对时,请将审批决定与 Money Movement 状态、来源账户的借记交易以及最终付款结果结合使用。

这可以为财务和运营团队提供从付款创建、到审批决定、再到最终执行结果的完整审计记录。

资金流动审批

Money Movement 审批的工作原理#

审批结果#

审批生命周期#

1. 创建需要审批的 Money Movement#

2. 运行客户的外部审批工作流#

3. 将决定发送给 Cobre#

4. Cobre 处理或取消 Money Movement#

功能行为#

审批待处理期间资金将被锁定#

审批是外部的,执行由 Cobre 强制执行#

审批只能发生一次#

审批对象概念#

对 Money Movement 审批可执行的操作#

如何开始#

使用此 API 之前#

使用 Money Movement 审批之前#

使用此 API 后的预期结果#

Money Movement 审批的工作原理

审批结果

审批生命周期

1. 创建需要审批的 Money Movement

2. 运行客户的外部审批工作流

3. 将决定发送给 Cobre

4. Cobre 处理或取消 Money Movement

功能行为

审批待处理期间资金将被锁定

审批是外部的,执行由 Cobre 强制执行

审批只能发生一次

审批对象概念

对 Money Movement 审批可执行的操作

如何开始

使用此 API 之前

使用 Money Movement 审批之前

使用此 API 后的预期结果