Cobre 退款

退款功能仍在积极开发中——本文档中描述的部分功能可能尚未对您的账户开放。请联系您的 KAM（关键客户经理）了解当前上线状态。

通过单一 API 对哥伦比亚收款（payin）轨道发起全额与部分退款

退款功能让 Cobre 客户能够针对原始 payin 将资金退还给付款人，而无需为每种支付方式单独构建自定义冲正逻辑。客户只需调用单一 endpoint 并引用原始交易，Cobre 会自动解析正确的付款（payout）轨道与路由。

1. Cobre 退款可实现什么

通过单次 API 调用，对已完成的 payin 资金流动或交易发起全额或部分退款。

通过 money_movement_id 或 transaction_id 引用原始交易——无需手动重建支付或付款人详情。

目前已支持哥伦比亚，覆盖 direct_debit_nequi（Nequi 代币化）与 r2p_breb。即将支持 r2p_pse、r2p_bancolombia 以及静态 BreB 密钥入账，并扩展至墨西哥（spei_credit、r2p_spei）。

可对同一原始 payin 发起多次部分退款，累计不超过其原始金额。

2. Cobre 模型中的退款

退款被建模为关联回原始 payin 的付款（payout）资金流动。当客户请求退款时，Cobre 会借记最初收到该 payin 的 Cobre Balance，并创建一笔向付款人的新 payout，复用该 payin 上已关联的交易对手信息。

退款仅适用于 payin 资金流动——转入（transfer-in）交易暂不符合条件。由于退款从最初收款的同一余额中扣款，该余额必须有足够资金才能处理退款；Cobre 不会从其他余额调取退款资金。

3. 关键能力

3.1 全额与部分退款

客户可退还 payin 的全部金额或其一部分。只要累计已退金额不超过原始收款金额，即可对同一原始 payin 多次发起部分退款。

3.2 灵活的交易引用

可通过原始 payin 的 money_movement_id 或其 transaction_id 请求退款，以便客户使用其内部已跟踪的任一标识符发起退款。

3.3 由 Cobre 解析轨道

客户无需选择或配置退款轨道。Cobre 根据原始 payin 的轨道及其已存档的交易对手解析正确的付款路由。

3.4 退款汇总——按 payin 累计总额

除每个单独的退款尝试外，Cobre 还会维护退款汇总——按原始 payin 累计运行总额。一次查询即可返回原始金额、已退金额、进行中尝试所预留金额、仍可退金额以及各尝试列表，无需客户自行拉取并加总每次尝试。

3.5 PSE 与 Bancolombia 退款的付款人数据采集（v2）

对于 Cobre 未在原始 payin 中收到付款人银行账户与身份数据的轨道（r2p_pse、r2p_bancolombia），退款尝试会以 waiting_for_information 状态创建，并返回 data_capture_url——付款人通过该链接安全提交缺失的银行账户与身份数据。付款人在 data_capture_url_expires_at 截止前完成该步骤后，退款将自动继续。

4. 核心概念与术语

Payin：贷记 Cobre Balance 且符合退款条件的原始资金流动。

Refund（退款）：由 Cobre 创建、引用原始 payin、并将资金退还给原付款人的 payout 资金流动。

Refund attempt（rfe_）：针对某 payin 的单次退款请求，具有独立状态生命周期。

Refund summary（rf_）：针对同一原始 payin 的所有退款尝试的累计总额器。

money_movement_id：Cobre 对资金流动的内部标识符；请求退款时引用原始 payin 的两种方式之一。

transaction_id：与原始 payin 关联的交易标识符；请求退款的另一种可接受引用。

Cobre Balance：为退款提供资金的虚拟余额；必须是收到原始 payin 的同一余额。

data_capture_url：退款尝试处于 waiting_for_information 时返回的链接，供付款人提交完成 PSE 或 Bancolombia 退款所需的银行账户与身份数据。

Counterparty：Cobre 用于路由退款的付款人账户记录。

5. 可靠性与依赖

退款完成取决于与已解析轨道上任何 payout 相同的因素——目标账户有效性以及底层轨道自身的处理行为。已全额退款的 payin 不能再请求退款，且部分退款累计金额不能超过原始 payin 金额。

6. 典型业务用例

客户争议或退款请求——向已收款后提出争议或要求冲正的付款人退还资金。

重复支付更正——规划中的未来用例：退还与另一笔已完成支付重复的 payin 资金。

退款适用于这些场景，因为客户无需离开 Cobre 平台，也无需手动重新录入原始交易中已知的 payout 详情，即可解决面向付款人的问题。

7. 交易、报表与对账

由于退款以 payout 资金流动形式发出，它会生成自己的交易记录，与原始 payin 交易不同但相互关联。客户可以像跟踪其他资金流动一样跟踪退款状态，并对照其在发起 Cobre Balance 上产生的借记进行对账。

8. 治理、控制与可审计性

退款由客户通过 API 发起——不存在面向付款人的自助退款流程。由于退款只能从收到原始 payin 的余额中扣款，退款能力自然受该余额可用资金限制。退款 payout 一旦执行，撤销并非内置能力——撤销需要在退款流程之外另行手动处理。

9. 总结——Cobre 退款交付什么

✔ 单一 API 向付款人退还资金，无需按轨道重建 payout 逻辑。

✔ 支持全额与部分退款，可通过 money_movement_id 或 transaction_id 引用。

✔ 基于原始 payin 自动解析轨道与交易对手。

✔ 内置余额纪律——退款仅从收到原始资金的余额扣款。

✔ 按 payin 报告累计总额的退款汇总，无需手动加总各次尝试。

✔ 为 PSE 与 Bancolombia 退款提供安全的付款人数据采集，即使 Cobre 尚未持有付款人银行详情也可继续退款。

退款为 Cobre 客户提供了在哥伦比亚 payin 轨道上直接解决付款人争议与更正请求的方式，随着能力扩展，还将覆盖更广泛的哥伦比亚与墨西哥轨道。

Cobre 退款

通过单一 API 对哥伦比亚收款（payin）轨道发起全额与部分退款#

1. Cobre 退款可实现什么#

2. Cobre 模型中的退款#

3. 关键能力#

3.1 全额与部分退款#

3.2 灵活的交易引用#

3.3 由 Cobre 解析轨道#

3.4 退款汇总——按 payin 累计总额#

3.5 PSE 与 Bancolombia 退款的付款人数据采集（v2）#

4. 核心概念与术语#

5. 可靠性与依赖#

6. 典型业务用例#

7. 交易、报表与对账#

8. 治理、控制与可审计性#

9. 总结——Cobre 退款交付什么#

通过单一 API 对哥伦比亚收款（payin）轨道发起全额与部分退款

1. Cobre 退款可实现什么

2. Cobre 模型中的退款

3. 关键能力

3.1 全额与部分退款

3.2 灵活的交易引用

3.3 由 Cobre 解析轨道

3.4 退款汇总——按 payin 累计总额

3.5 PSE 与 Bancolombia 退款的付款人数据采集（v2）

4. 核心概念与术语

5. 可靠性与依赖

6. 典型业务用例

7. 交易、报表与对账

8. 治理、控制与可审计性

9. 总结——Cobre 退款交付什么