En Recurrente, creemos en la libertad de integración sin restricciones de proveedores. Es por eso que ofrecemos acceso sin costos de inscripción ni cuotas de suscripción. Además, ahora permitimos el uso de cualquier certificador de facturas para emitir facturas electrónicas en Recurrente. Esta guía está dirigida a desarrolladores que quieren integrar su sistema de facturación con Recurrente. Si eres cliente y deseas implementar una solución de facturación personalizada, por favor, comparte esta guía con tus desarrolladores.
Flujo General para Integración
Obtener Llaves API
Configurar Webhooks
Emitir Facturas
Enviar el URL de la factura
Para integraciones con Infile específicamente, sigue el procedimiento detallado en esta guía.
Obtener API Keys
En la cuenta que vas a integrar, entra a Configuración → Llaves API y copia la llave secreta.
Configurar Webhooks
- Realiza una petición POST a /api/webhooks con los parámetros url y description. Un webhook es un método que permite a aplicaciones externas recibir información automática de Recurrente. Deberás generar un URL único para cada cliente que utilices en esta configuración.
Payload de ejemplo que recibirás:
{ "id": "pa_id123", "event_type": "payment_intent.succeeded", "amount_in_cents": 10000, "currency": "GTQ", ... }
Con estos datos, podrás procesar y emitir la factura correspondiente a tu cliente. Es importante guardar el id del PaymentIntent (pa_id123 en el ejemplo) para poder actualizarlo con el URL de la factura luego.
Emitir Facturas
Este proceso se realiza en tu sistema. Una vez emitida la factura, guarda el URL de la misma ya que será necesario para el paso siguiente.
Enviar el URL de la factura a Recurrente
Envía un PATCH a /api/payment_intents/<id> incluyendo el ID del intento de pago que guardaste anteriormente.
Payload:
{ "payment_intent": { "tax_invoice_url": "https://ejemplo.com/factura123" }}
Esto hará que se guarde la factura en el PaymentIntent y se le muestre al usuario de la siguiente manera en la plataforma de Recurrente:
Listo! Ya estás facturando con Recurrente.
¿Necesitas más ayuda? Contacta a soporte por correo [email protected] o escríbenos por WhatsApp.