Comenzar

Introducción

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-PUBLIC-KEY: tu_llave_publica" \
>  -H "X-SECRET-KEY: tu_llave_privada"
  1. Crea tu primer checkout:
$curl -X POST https://app.recurrente.com/api/checkouts \
>  -H "X-PUBLIC-KEY: tu_llave_publica" \
>  -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.

¿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

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?