创建退款

针对现有 payin Money Movement 或 Transaction 创建退款。Cobre 解析原始 payin 收款所用的轨道，验证可退性，并创建一笔 debit 最初收款 Cobre Balance 的 payout Money Movement。
:::

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

退款生命周期

创建的资源是一次退款尝试（refund_entry），由 rfe_ 前缀标识。其 status 会经历：

状态	描述
`processing`	退款已接受，其底层 payout 正在执行。
`completed`	退款的 payout 已结算至付款人。
`failed`	退款的 payout 未能完成。
`rejected`	退款的 payout 被拒绝。
`waiting_for_information`	Cobre 正在等待付款人分享并验证银行账户与身份数据（仅适用于 `r2p_pse` 与 `r2p_bancolombia` 退款）。

只要累计金额不超过原始 payin，最多允许对同一原始 payin 发起 100 次部分退款。

📘 了解更多： 退款 API

Provide your bearer token in the

Authorization

header when making requests to protected resources.

Example:

Authorization: Bearer ********************

curl --location 'https://api.cobre.co/v1/refunds' \ --header 'Idempotency-Key: rf_mm_xOBCRu3PPAby6E_3f7a1e9c-6b2e-4b7a-9f2b-2c1e6b7a9f2b' \ --header 'Authorization: Bearer <token>' \ --header 'Content-Type: application/json' \ --data '{ "original_payin_id": "mm_xOBCRu3PPAby6E", "amount": 10000, "description": "客户申请的退款", "redirect_url": "https://www.cobre.com/es-co" }'

{ "id": "rfe_bK2xLp9vNm4wYz", "object": "refund_entry", "livemode": true, "request_id": "req_bfsakd456fgh", "original_payin_id": "mm_xOBCRu3PPAby6E", "amount": 10000, "status": "waiting_for_information", "data_capture_url": "https://refund.cobre.co/...", "data_capture_url_expires_at": "2026-08-05T20:02:11Z", "redirect_url": "https://www.cobre.com/es-co", "created_at": "2026-08-05T14:02:11Z", "updated_at": "2026-08-05T14:02:11Z", "description": "我的第一笔退款" }

创建退款

退款生命周期

Request

Responses

创建退款

退款生命周期#

Request

Responses

退款生命周期