Create a Refund

Creates a refund against an existing payin Money Movement or Transaction. Cobre resolves the rail the original payin was received on, validates refundability, and creates a payout Money Movement debiting the Cobre Balance that received the original funds.
:::

Refunds is still under active development — some of the functionality described in this guide may not yet be available for your account. Contact your KAM (Key Account Manager) for the current rollout status.

Refund Lifecycle

The created resource is a refund attempt (refund_entry), identified by the rfe_ prefix. Its status moves through:

Status	Description
`processing`	The refund has been accepted and its underlying payout is being executed.
`completed`	The refund's payout has settled to the payer.
`failed`	The refund's payout could not be completed.
`rejected`	The refund's payout was rejected.
`waiting_for_information`	Cobre is waiting for the payer to share and verify bank account and identification data (applies only to `r2p_pse` and `r2p_bancolombia` refunds).

Up to 100 partial refunds are allowed against the same original payin, as long as their combined amount never exceeds it.

Provide your bearer token in the

Authorization

header when making requests to protected resources.

Example:

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

curl --location 'https://api.cobre.co/v1/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": "Refund requested by customer", "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" }

Create a Refund

Refund Lifecycle

Request

Responses

Create a Refund

Refund Lifecycle#

Request

Responses

Refund Lifecycle