Introducción

La API de Recurrente te permite crear sesiones de compra, manejar tus productos, suscripciones, y clientes, hacer transferencias de dinero entre diferentes cuentas de Recurrente, y mucho más.

Cómo empezar

• Crea una cuenta en Recurrente.
• La API responde en formato JSON. Cuando retorna un error, el error es enviado en un error key en JSON.

URL Base

https://app.recurrente.com/api

Inicio Rápido

1. Obtén tus llaves de API desde el panel de Recurrente en Configuración → Llaves API
2. Prueba tus credenciales con una solicitud GET simple:

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

3. Crea tu primer checkout:

$
curl -X POST https://app.recurrente.com/api/checkouts \
>
  -H "X-SECRET-KEY: tu_llave_secreta" \
>
  -H "Content-Type: application/json" \
>
  -d '{
>
    "items": [{
>
      "name": "Camiseta",
>
      "amount_in_cents": 15000,
>
      "currency": "GTQ",
>
      "quantity": 1
>
    }],
>
    "success_url": "https://tusitio.com/exito",
>
    "cancel_url": "https://tusitio.com/cancelar"
>
  }'

Esto retorna una checkout_url — redirige a tu cliente ahí para completar el pago.

Para montos inline, amount_in_cents debe respetar el mínimo de la moneda: 500 para GTQ (Q5) o 100 para USD ($1).

¿Qué puedes hacer con la API?

Sandbox y pagos de prueba

Existen dos formas de realizar pruebas: usando el ambiente Sandbox o haciendo pruebas directamente en producción, dependiendo del tipo de validación que necesites.

✅ Ambiente Sandbox

El ambiente Sandbox permite hacer pagos de prueba sin generar actividad real. Para utilizarlo:

• Usa tus llaves de ambiente TEST.
• Simula un pago exitoso con la tarjeta 4242 4242 4242 4242.

Los checkouts creados con llaves TEST:

• Muestran un aviso que dice “PRUEBA” en el link de pago.
• Tienen el atributo live_mode = false.
• No crean actividad en la cuenta ni afectan el balance.
• No disparan webhooks.

Este ambiente es ideal para pruebas durante la integración inicial o desarrollo.

⚠️ Pruebas en producción

También es posible realizar pruebas en ambiente LIVE con tus llaves de producción. En estos casos:

• Se recomienda reembolsar los pagos de prueba el mismo día, ya sea desde el panel de Recurrente o mediante la API en /api/refunds.
• Los pagos reembolsados el mismo día son reembolsados al 100% del monto.

Esta opción permite validar el flujo completo, incluyendo actividad en cuenta, webhooks y conciliación.

¿Necesitas ayuda?

• Si estás usando Wordpress, te recomendamos que utilices nuestro plugin.
• Únete y pregunta en nuestro Discord.
• O envíanos un correo a soporte@recurrente.com