Autenticación

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

Header	Descripción
`X-SECRET-KEY`	Tu llave secreta de API

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.

Inicia sesión en el Panel de Recurrente
Ve a Configuración → Llaves API
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

Ambiente	URL Base
Producción	`https://app.recurrente.com/api`
Pruebas	`https://app.recurrente.com/api` (usa llaves modo test)

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

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	}