Rekurra API v1 ya disponible. Ver changelog →
Errores

Errores

Toda respuesta de error de la API programática de Rekurra sigue la misma forma:

{
  "error": {
    "type": "invalid_request",
    "code": "missing_field",
    "message": "El campo 'email' es obligatorio.",
    "param": "email",
    "request_id": "req_01HZXK7QJ5M8Z9X2R3TVQ7A1B2"
  }
}
CampoDescripción
typeCategoría del error (ver tabla abajo)
codeCódigo específico y estable, útil para manejar el error programáticamente
messageMensaje legible en español (es-CO) — no lo muestres crudo al usuario final sin traducir tu propio copy si necesitas otro tono
paramCampo del request que causó el error, si aplica
request_idIdentificador único de la request — inclúyelo si escribes a soporte

Tipos de error (error.type)

typeSignificado
invalid_requestEl request está mal formado o referencia un recurso inexistente
authentication_errorFalta la API key, es inválida o fue revocada
rate_limitSe superó el límite de requests por llave
api_errorError interno de Rekurra — reintenta con backoff
wompi_errorWompi rechazó o falló al procesar la operación
insufficient_balanceTu saldo prepago no alcanza para cubrir el fee proyectado

Status codes

StatusSignificado
200OK
201Creado
400Request inválido (campos faltantes o mal formados)
401Autenticación fallida (API key faltante, inválida o revocada)
403La API key no tiene el scope necesario
404El recurso no existe o no pertenece a tu cuenta
409Conflicto (por ejemplo, Idempotency-Key reusada con un body distinto, o code duplicado)
422Regla de negocio violada (por ejemplo, saldo insuficiente o rechazo de Wompi)
429Límite de tasa superado
5xxError interno de Rekurra

Buenas prácticas

  • Reintenta 429 y 5xx con backoff exponencial.
  • No reintentes 400, 401, 403, 404 ni 422 sin corregir el request — el resultado será el mismo.
  • Usa Idempotency-Key en operaciones de creación (POST de suscripciones, cobros manuales) para que un reintento de red no cree un recurso duplicado.
  • Registra siempre request_id en tus logs para poder correlacionar con soporte de Rekurra.
EventsChangelog