Changelog
API — 2026-09-13
- Nuevo endpoint
GET /v1/checkout-sessions/{id}/status: consulta manual del resultado del checkout (estado +subscription_id) para cuando no llegó el webhooksubscription.created. Tiene un rate limit dedicado de 20/min por API key (además del global de 100/min); al superarlo responde429rate_limit. Documentado en Checkout sessions e incluido en la colección de Postman.
Documentación — 2026-09-13
Mejoras de claridad en la documentación (sin cambios en la API):
- La guía de checkout ahora se llama Crear una suscripción (orientada a la meta, no al mecanismo). El checkout hospedado es la vía documentada para crear suscripciones.
- Definición de cada campo en las guías de crear plan y crear suscripción,
y tablas de campos consistentes en toda la referencia
(
Campo · Tipo · Requerido · Descripción). - Ejemplos de código en pestañas por lenguaje: curl, JavaScript, Python, Java y C#.
- La guía de crear suscripción muestra ejemplos claros para cliente nuevo
(
customer) y cliente existente (customer_id). - Nueva colección de Postman descargable con los endpoints principales.
v1 — 2026-08-24
Lanzamiento inicial de la API pública de Rekurra.
- Autenticación por API key (
rk_live_.../rk_test_...), modos live y test, scopes y revocación. - Recursos
/v1/plans,/v1/customers,/v1/payment-methods,/v1/subscriptions,/v1/checkout-sessions,/v1/charges,/v1/balance,/v1/webhook-endpoints,/v1/events. - Checkout hospedado (
checkout.rekurra.dev) para suscribir clientes nuevos sin construir un formulario de pago propio. - Webhooks salientes firmados con
Rekurra-Signature(HMAC-SHA256). - Modelo de saldo prepago con fee por cobro aprobado (Hobby, Builder, Scale) y pausa automática por saldo insuficiente con 3 días de gracia.
- Todo el dinero en COP, expresado en centavos (enteros) en toda la API.