Skip to navigation
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.

Tu primer pago de prueba

Sigue Primer pago de prueba para abrir un Sandbox, obtener una llave TEST y verificar tu primer pago y webhook. Puedes empezar antes de activar cobros reales.

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. En Configuración → Llaves API → Abrir Sandbox, elige Crear mi llave TEST. Confirma environment: sandbox antes de crear pagos.
  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.

Consulta el contrato de cada endpoint: transferencias, splits, swaps, retiros y comandos de hardware están bloqueados. Las simulaciones de tarjeta admiten éxito y rechazo; no reproducen 3DS ni liquidación bancaria. 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?