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 solo están disponibles para pagos con tarjeta. Las transacciones de SPEI, OXXO Pay y MercadoPago no pueden reembolsarse.
Prerrequisitos
- El ID de la transacción original que quieres reembolsar.
Limitaciones importantes
- Los reembolsos funcionan exclusivamente con transacciones de tarjeta de crédito y débito.
- 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.