Comenzar

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"
  1. 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?

FuncionalidadDescripción
CheckoutsCrear páginas de pago alojadas
ProductosManejar tu catálogo y precios
SuscripcionesManejar facturación recurrente
ClientesRastrear y administrar tus compradores
ReembolsosProcesar reembolsos de pagos
TransferenciasEnviar dinero entre cuentas
WebhooksRecibir notificaciones sobre eventos

Sandbox y pagos de prueba

Cada Sandbox es un ambiente aislado con miembros, llaves TEST, webhooks, objetos, actividad y balances simulados propios. Puedes probar el ciclo completo de una suscripción —cobro inicial, renovación, rechazo, recuperación, refund y cancelación— sin dinero real ni datos LIVE.

Usa 4242 4242 4242 4242 para éxito o 4000 0000 0000 0002 para rechazo. Los eventos normales se entregan solamente a los endpoints del Sandbox con live_mode: false y sandbox_id.

Toda la API pública está disponible: las operaciones que normalmente contactan un proveedor persisten simulaciones locales. Para probar únicamente un consumer de webhooks, /test_helpers/webhook_events puede emitir cualquier evento publicado; para probar comportamiento, usa el flujo real y sus eventos naturales.

Consulta la guía de Sandboxes para crear un ambiente, usar Test Clocks y ejecutar el escenario end-to-end.

¿Necesitas ayuda?