Cómo Conectar Recurrente con tu Sitio Web (API Básica)

Si tienes un sitio web propio y quieres conectar Recurrente para procesar pagos directamente, la API de Recurrente te permite hacerlo de forma sencilla. Esta guía de API básica te llevará desde la obtención de tus credenciales hasta procesar tu primer pago en tu sitio web.

¿Por qué usar la API de Recurrente?

La API es ideal cuando necesitas más control sobre la experiencia de compra. Mientras que los links de pago y la tienda de Recurrente funcionan sin código, la API te permite:

Integrar pagos en tu propio diseño: El checkout se siente parte de tu sitio.
Automatizar procesos: Crear productos, generar links y gestionar suscripciones programáticamente.
Recibir notificaciones en tiempo real: Webhooks que avisan cuando un pago se completa o falla.
Sincronizar con tu sistema: Conectar con tu CRM, ERP o base de datos.

Requisitos previos

Cuenta activa y verificada en Recurrente
Conocimientos básicos de programación (o un desarrollador que te apoye)
Un sitio web con backend (WordPress, Next.js, Laravel, etc.)
HTTPS habilitado en tu dominio (obligatorio para pagos)

Paso 1: Obtén tus credenciales de API

Desde tu dashboard de Recurrente, ve a Configuración > API. Aquí encontrarás:

API Key (pública): Se usa en el frontend para crear checkouts.
Secret Key (privada): Se usa en el backend para operaciones sensibles. Nunca la expongas en el frontend.

También tendrás acceso a un ambiente de pruebas (sandbox) con credenciales separadas para que puedas probar sin procesar pagos reales.

Paso 2: Crea un checkout desde tu backend

La forma más común de integración es crear un checkout session desde tu servidor. Aquí un ejemplo básico:

Haces una petición POST a la API de Recurrente con los datos del producto (nombre, precio, cantidad) y la URL a la que quieres redirigir al cliente después del pago. La API te devuelve una URL de checkout a la que rediriges al cliente.

El cliente completa el pago en la página segura de Recurrente e ingresa los datos de su tarjeta. Una vez completado, se redirige de vuelta a tu sitio.

Paso 3: Configura webhooks

Los webhooks son notificaciones automáticas que Recurrente envía a tu servidor cuando algo importante sucede. Configura una URL en tu servidor para recibir estos eventos:

payment.completed: El pago se procesó exitosamente.
payment.failed: El pago fue rechazado.
subscription.created: Se creó una nueva suscripción.
subscription.cancelled: El cliente canceló su suscripción.

Siempre verifica la firma del webhook para asegurarte de que proviene de Recurrente y no de un tercero malicioso.

Paso 4: Verifica el pago

Cuando recibes un webhook de pago completado, verifica el estado de la transacción haciendo una consulta a la API con el ID de la transacción. Esto es una capa extra de seguridad para confirmar que el pago es legítimo antes de entregar el producto o servicio.

Ejemplo de flujo completo

El cliente agrega productos al carrito en tu sitio.
Al hacer clic en "Pagar", tu backend crea un checkout session vía API.
Rediriges al cliente a la URL de checkout de Recurrente.
El cliente ingresa datos de tarjeta y paga.
Recurrente envía un webhook a tu servidor confirmando el pago.
Tu servidor actualiza el pedido como "pagado" y notifica al cliente.
El cliente es redirigido a tu página de confirmación.

Integraciones populares

Si no quieres desarrollar desde cero, Recurrente ofrece integraciones pre-construidas:

WordPress/WooCommerce: Plugin que se instala en minutos.
Shopify: Integración directa desde la tienda de apps.
Zapier: Conecta Recurrente con miles de apps sin código.

Para sitios custom (React, Next.js, Vue, Angular, Laravel, Django, etc.), la API REST es la mejor opción.

Buenas prácticas de integración

Usa siempre HTTPS: Nunca proceses pagos en HTTP.
No guardes datos de tarjeta: Recurrente maneja eso por ti con tokenización.
Prueba en sandbox primero: Verifica todo el flujo antes de ir a producción.
Maneja errores gracefully: Si un pago falla, muestra un mensaje claro al usuario.
Implementa idempotencia: Evita cobros duplicados si hay reintentos.
Registra todo: Guarda logs de transacciones y webhooks para debugging.

Documentación y soporte

Recurrente cuenta con documentación técnica completa en su sitio de desarrolladores. Ahí encontrarás endpoints detallados, ejemplos de código en varios lenguajes y guías de integración específicas para cada plataforma.

Si necesitas ayuda, el equipo de soporte técnico de Recurrente puede asistirte durante tu integración.

Conclusión

Conectar Recurrente a tu sitio web a través de la API te da control total sobre la experiencia de pago. Ya sea que tengas un e-commerce complejo o un sitio simple que necesita cobrar por un servicio, la API de Recurrente se adapta a tus necesidades. Crea tu cuenta y empieza a integrar pagos en tu sitio web hoy.