Rekurra

Rekurra es una capa de billing recurrente construida sobre Wompi para desarrolladores y negocios en Colombia. Te da suscripciones, planes, clientes, métodos de pago y checkout hospedado — sin que tengas que construir tu propio motor de cobros recurrentes.

¿Cómo funciona?

• Multi-tenant: cada desarrollador conecta su propia cuenta de Wompi (llaves pública, privada, de eventos y de integridad). El recaudo del dinero de tus clientes ocurre siempre en tu cuenta de Wompi, nunca en la de Rekurra.
• Rekurra orquesta el ciclo de vida: crea el plan, registra el cliente, tokeniza el método de pago, agenda y ejecuta los cobros recurrentes, aplica reintentos (dunning) y te notifica por webhook.
• Modelo de precio: Rekurra cobra una comisión (fee) sobre cada cobro aprobado, descontada automáticamente de tu saldo prepago. Ver Saldo prepago para el detalle exacto por plan.
• Todo el dinero es en pesos colombianos (COP), expresado en centavos (enteros) en toda la API. Por ejemplo, $50.000 COP se representa como 5000000 centavos.

Quickstart

1. Crea tu cuenta y genera una API key

Regístrate en el dashboard de Rekurra, conecta tu cuenta de Wompi (ver Conectar Wompi) y genera una API key de prueba desde Configuración → API keys. Ver Autenticación para el detalle de scopes y modos live/test.

2. Crea un plan

curl -X POST https://api.rekurra.dev/v1/plans \
  -H "Authorization: Bearer rk_test_XXXXXXXXXXXXXXXXXXXXXXXX" \
  -H "Content-Type: application/json" \
  -d '{
    "code": "pro-mensual",
    "name": "Plan Pro",
    "price_monthly_cents": 5000000,
    "trial_days": 7
  }'

3. Crea una sesión de checkout hospedado

curl -X POST https://api.rekurra.dev/v1/checkout-sessions \
  -H "Authorization: Bearer rk_test_XXXXXXXXXXXXXXXXXXXXXXXX" \
  -H "Content-Type: application/json" \
  -d '{
    "plan_id": "plan_01H...",
    "cycle": "monthly",
    "customer": { "email": "cliente@ejemplo.com" },
    "success_url": "https://tuapp.com/gracias",
    "cancel_url": "https://tuapp.com/checkout"
  }'

Redirige a tu cliente a la url de la respuesta. Rekurra tokeniza la tarjeta sobre tu cuenta de Wompi y crea el cliente, el método de pago y la suscripción automáticamente.

4. Escucha los webhooks

Registra un endpoint en /v1/webhook-endpoints para recibir eventos como subscription.created o charge.approved, firmados con Rekurra-Signature. Ver Webhooks.