Obtener un Resumen de Reembolso

Designing

GET

https://api.cobre.co/v1/v1/refund/summary/{id}

Recupera el resumen de reembolso de un payin original por su ID rf_ — el total acumulado de todos los intentos de reembolso sobre ese payin (monto original, monto ya reembolsado, monto reservado por intentos en curso y monto aún reembolsable), junto con la lista de intentos individuales.

Esto es distinto de un intento de reembolso individual (refund_entry, prefijo rfe_, Obtener un Reembolso): el resumen es el acumulador por payin, mientras que un intento es una solicitud de reembolso sobre ese payin. Si un payin tiene múltiples intentos, este endpoint devuelve la vista agregada; recupere un intento individual por su propio ID rfe_.

Reembolsos aún está en desarrollo activo: parte de la funcionalidad descrita en esta guía puede no estar disponible todavía para su cuenta. Contacte a su KAM (Key Account Manager) para conocer el estado actual del despliegue.

Request

Authorization

Provide your bearer token in the

Authorization

header when making requests to protected resources.

Example:

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

Path Params

Responses

🟢200OK

application/json

El resumen de reembolso solicitado.

Bodyapplication/json

🟠404No encontrado

🟠401No autorizado

🟠403Prohibido

🟠429Demasiadas solicitudes

🔴500Error interno del servidor

Request Example

Shell

JavaScript

Java

Swift

curl --location 'https://api.cobre.co/v1/v1/refund/summary/rf_xOBCRu3PPAby6E' \
--header 'Authorization: Bearer <token>'

Response Example

200 - OK

{
    "id": "rf_xOBCRu3PPAby6E",
    "object": "refund_summary",
    "livemode": true,
    "request_id": "req_asdasdfa123",
    "original_payin_id": "mm_xOBCRu3PPAby6E",
    "currency": "COP",
    "original_amount": 300,
    "refunded_amount": 200,
    "reserved_amount": 0,
    "refundable_amount": 100,
    "status": "partially_refunded",
    "refunds": [
        { "id": "rfe_nQ8vLm2KxP4wYz", "amount": 100, "status": "completed", "created_at": "2026-08-05T14:02:11Z" },
        { "id": "rfe_nQ8vLm2KxP1234", "amount": 100, "status": "completed", "created_at": "2026-08-05T14:02:11Z" }
    ]
}

Modified at 2026-09-15 19:39:30

Obtener un Reembolso

Obtener todos los Reembolsos