Autenticación

Todas las solicitudes de API requieren autenticación a través del header HTTP X-SECRET-KEY:

La llave secreta determina la cuenta y el ambiente (producción o prueba).

Encontrar Tus Llaves

Para encontrar tus Llaves de API, dentro de tu cuenta de Recurrente, ve a:

Configuración → Llaves API.

1. Inicia sesión en el Panel de Recurrente
2. Ve a Configuración → Llaves API
3. Copia tu llave secreta. Solo se muestra completa al generarla o rotarla.

Modo Producción vs Prueba

Tu cuenta tiene dos llaves secretas:

• Llaves de prueba — Úsalas durante el desarrollo. No se mueve dinero real.
• Llaves de producción — Úsalas en producción. Se procesan transacciones reales.

El endpoint de la API es el mismo para ambos modos. La llave secreta determina en qué ambiente estás operando.

Solicitud de Ejemplo

$
curl https://app.recurrente.com/api/test \
>
  -H "X-SECRET-KEY: sk_live_xyz789..."

Error en la autenticación

Si tus llaves de API no se están enviando o son inválidas, recibirás un código de respuesta HTTP 401 Unauthorized:

1
{
2
  "message": "Autenticación Errónea 👀",
3
  "errors": {
4
    "authentication": [
5
      "Las llaves de API son inválidas o no coinciden."
6
    ]
7
  }
8
}

Ambientes