Ir al contenido

↑↓ navegar ↵ abrir Ctrl↵ nueva pestaña esc cerrar
CódigoSignificado
200Éxito (GET, PATCH, batch)
201Transacción creada (POST individual)
401Credenciales ausentes o inválidas
403Empresa bloqueada, o ningún producto que usa transacciones activo (solo en la creación)
404Transacción o merchant no encontrado
405Las transacciones no se pueden eliminar (DELETE), ver Eliminar transacción
409Conflicto (duplicado, o actualización de transacción inmutable)
422Error de validación (campos inválidos)
429Demasiadas solicitudes (límite: 100 por minuto por IP)
500Error interno del servidor

Todas las respuestas de error siguen el mismo formato:

{
"error": {
"code": "ERROR_CODE",
"message": "Descripción del error"
}
}

CódigoHTTPMensaje
UNAUTHORIZED401Missing or invalid Authorization header
UNAUTHORIZED401Invalid Basic Auth format
UNAUTHORIZED401Missing client_id or client_secret
UNAUTHORIZED401Invalid credentials
COMPANY_BLOCKED403Company is blocked
CódigoHTTPMensaje
VALIDATION_ERROR422Mensaje del validador (ej.: card_last4 must be exactly 4 digits)
CódigoHTTPMensaje
TRANSACTION_NOT_FOUND404Transaction not found
TRANSACTION_DUPLICATE409Transaction already exists
TRANSACTION_DUPLICATE409Another transaction with this external_source/external_id already exists
TRANSACTION_IMMUTABLE409Transaction cannot be modified: it has been used by a network event
TRANSACTION_DELETE_NOT_ALLOWED405Transactions cannot be deleted
MERCHANT_NOT_FOUND404Merchant not found
PRODUCT_NOT_ACTIVE403Transactions require an active Prevention or Dispute product

PRODUCT_NOT_ACTIVE solo aparece en la creación (POST /transactions y POST /transactions/batch), cuando la empresa no tiene Prevención ni Disputa activa. Consultar y actualizar no exigen producto activo. Ver Quién envía transacciones.

CódigoHTTPMensaje
RATE_LIMIT_EXCEEDED429Rate limit exceeded, retry in X seconds

En el endpoint de batch, los errores individuales se devuelven en el array errors dentro de data, sin interrumpir el procesamiento de las demás transacciones:

{
"data": {
"created": 1,
"failed": 2,
"results": [
{ "external_id": "TXN-2026-001", "tx_id": "uuid-1", "warnings": [] }
],
"errors": [
{ "index": 1, "external_id": "TXN-2026-002", "status": 409, "error": "Transaction already exists" },
{ "index": 2, "external_id": "TXN-2026-003", "status": 404, "error": "Merchant not found" }
]
}
}

La excepción es el 403 PRODUCT_NOT_ACTIVE: sin Prevención ni Disputa activa, la llamada entera se rechaza con 403 y no se crea ninguna transacción. No aparece en el array errors.

Cada error incluye:

  • index: posición de la fila en el array que enviaste, empezando en cero.
  • external_id: identifica qué transacción falló.
  • status: código HTTP equivalente del error.
  • error: mensaje descriptivo.