Para el dueño: qué significa “integrar”
Integrar es que dos sistemas se hablen solos. Cuando vendes en tu POS, tu programa de puntos se entera y suma los puntos al cliente, sin que nadie lo digite dos veces.
Las dos piezas: API y webhooks
- API: tu sistema le habla a FIELIO. Por ejemplo, “registra esta venta de S/ 45 para este cliente”.
- Webhooks: FIELIO le habla a tu sistema. Por ejemplo, “este cliente acaba de canjear un premio”.
Conecta tu sistema con FIELIO
API REST pública v1, webhooks firmados y colección de Postman para empezar a integrar hoy.
Ver la documentación de la APIQué se puede hacer con la API de FIELIO
- Crear, consultar y actualizar clientes.
- Registrar transacciones y que sumen puntos o sellos.
- Consultar el catálogo de recompensas y registrar canjes.
- Obtener el enlace de la tarjeta Wallet de un cliente.
La documentación pública está en fielio.app/api, con la especificación OpenAPI y una colección de Postman para probar.
Eventos disponibles por webhook
cliente.created: se registró un cliente nuevo.transaccion.created: se registró una venta o visita.canje.created: un cliente canjeó una recompensa.
Para el desarrollador: seguridad y reintentos
- Cada petición a la API se autentica con una API key del negocio, que se puede revocar en cualquier momento.
- Cada webhook va firmado con HMAC SHA-256 para que verifiques que viene de FIELIO.
- Si tu servidor no responde, FIELIO reintenta el envío con espera exponencial.
- El secreto del webhook se muestra una sola vez al crearlo, y puedes rotarlo.
Integraciones nativas
Si usas Bsale, Alegra, Siigo, HubSpot o Salesforce, el plan Enterprise de FIELIO Suite incluye integración nativa, sin programar.
No tienes que elegir entre tu sistema actual y un programa de fidelización. Puedes tener los dos, conectados.