Reembolsos
Cómo reembolsar un pago con tarjeta, con las reglas que lo limitan: total, una vez, 29 días.
La funcionalidad de reembolsos de Tonder permite a los comercios devolver fondos a los clientes en
transacciones con tarjeta. La usas para devoluciones, cancelaciones o cualquier situación que
requiera revertir un pago. Los reembolsos se procesan por el mismo endpoint unificado /process/
usando operation_type: "refund".
Los reembolsos están disponibles para pagos con tarjeta y, en Argentina, para pagos con QR —en total, una sola vez (consulta Argentina). En Argentina, las transferencias bancarias (CVU) se reembolsan por soporte. Las transacciones de SPEI, OXXO Pay y MercadoPago no pueden reembolsarse.
También existe un endpoint agnóstico al procesador,
POST /business/{business_id}/payments/{transaction_reference}/refunds,
que solo recibe el amount. Es la vía de reembolso para integraciones Web SDK, y las
integraciones API Direct también pueden usarlo.
Prerrequisitos
- El ID de la transacción original que quieres reembolsar.
Limitaciones importantes
- Los reembolsos funcionan con transacciones de tarjeta y, en Argentina, con pagos con QR.
- Cada transacción solo puede reembolsarse una vez, y en su totalidad.
- Los reembolsos deben procesarse dentro de los 29 días posteriores a la confirmación del pago.
Paso 1: haz la petición de reembolso
Envía tu petición al endpoint /process/ con estos cuatro campos:
| Campo | Tipo | Requerido | Descripción |
|---|---|---|---|
operation_type | string | Sí | Debe ser "refund". |
amount | decimal | Sí | Monto del reembolso (total). |
currency | string | Sí | Código de moneda (debe coincidir con la transacción original). |
original_transaction_id | string | Sí | ID de la transacción de pago original. |
curl -X POST https://stage.tonder.io/api/v1/process/ \
-H "Authorization: Token YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"operation_type": "refund",
"amount": 50.00,
"currency": "MXN",
"original_transaction_id": "6ada8797-235e-4674-86de-7b23e90e1163"
}'Paso 2: maneja la respuesta
Ante una petición exitosa, la API devuelve una confirmación inmediata:
{
"id": "07230c98-e749-4d27-a90d-6f3e117205aa",
"operation_type": "refund",
"status": "Success",
"amount": 50.0,
"currency": "MXN",
"client_reference": null,
"transaction_id": "20832559",
"provider": "tonder",
"created_at": "2025-09-18T15:38:38.157382Z",
"status_code": 201,
"original_transaction_id": "6ada8797-235e-4674-86de-7b23e90e1163",
"reason": null,
"refund_id": "74"
}| Campo | Descripción |
|---|---|
id | Identificador único de la transacción de reembolso. |
operation_type | Tipo de operación ("refund"). |
status | Estado actual del reembolso ("Success", "Failed", etc.). |
amount | Monto reembolsado. |
currency | Código de moneda. |
original_transaction_id | ID de la transacción de pago original. |
refund_id | Identificador interno del reembolso. |
created_at | Marca de tiempo de creación del reembolso. |
status_code | Código HTTP de la respuesta. |
Valida siempre id (identificador único, guárdalo) y status (estado actual del reembolso). Nunca
confíes solo en el código HTTP.