Fint ofrece una API REST completa para integrar la gestión de cobranzas con tus sistemas existentes: ERPs, sistemas académicos, CRMs y más.
Primeros Pasos
Configurá la autenticación
Incluí tu API Key en el header x-api-key de cada solicitud.
Realizá tu primera llamada
Probá la conexión con el endpoint de health check.
Autenticación
Todos los endpoints requieren autenticación mediante API Key:
curl -X GET "https://api.fint.app/api/v1/health" \
-H "x-api-key: TU_API_KEY"
Nunca expongas tu API Key en código del lado del cliente. Mantené las llamadas a la API en tu backend.
Conceptos Clave
Contactos
Los contactos representan a tus clientes y responsables de pago. Aprendé sobre su ciclo de vida y estados.
Webhooks
Recibí notificaciones en tiempo real cuando ocurren eventos en Fint, como pagos completados.
Casos de Uso Comunes
Sincronizar clientes desde tu sistema académico
// Crear un nuevo contacto (cliente)
const response = await fetch('https://api.fint.app/api/v1/contacts', {
method: 'POST',
headers: {
'x-api-key': 'TU_API_KEY',
'Content-Type': 'application/json'
},
body: JSON.stringify({
firstName: 'Juan',
lastName: 'Pérez',
email: 'juan.perez@email.com',
externalReference: 'CLIENTE-12345' // ID de tu sistema
})
});
Recibir notificaciones de pago
Configurá un webhook para recibir eventos cuando un pago se complete:
{
"event": "payment.created",
"data": {
"paymentId": "pay_abc123",
"amount": 15000,
"contactId": "con_xyz789"
}
}
Recursos
API Reference
Documentación completa de endpoints
Webhooks
Configuración y eventos disponibles
Contactos
Modelo de datos y ciclo de vida
Entornos
| Entorno | URL Base |
|---|
| Producción | https://api.fint.app/api/v1 |
| Desarrollo | https://dev.api.fint.app/api/v1 |
Soporte Técnico
¿Tenés dudas sobre la integración? Escribinos a soporte@fint.app con el asunto “Integración API”. 
