Configuración e integraciones
Conectores listos para enchufar: cada integración se habilita con variables de entorno, sin tocar código de producto. Ver .env.example y docs/INTEGRATIONS.md.
POS / Caja (carrito mixto)
pos
Consulta de saldos por QR desde caja, matching de líneas de ticket, reserva, confirmación y reversa.
ERP / Facturación
erp
Remitos digitales, cuenta corriente B2B y conciliación de retiros por tramos.
Proveedor de identidad
auth
Email/OTP para compradores, 2FA obligatorio para administradores de empresa.
PostgreSQL (ledger y transaccional)
database
Fuente de verdad: balances, ledger append-only, contratos versionados, auditoría.
Redis (QR dinámico y locks)
infra
Tokens de QR de un solo uso con expiración corta y locks de redención concurrente.
Analytics / eventos
analytics
Pipeline de eventos (offer_accepted, redemption_completed, …) hacia el warehouse.
Email transaccional
Activaciones, vencimientos próximos, respuestas de reclamos y constancias.
Notificaciones push
notifications
Saldo activado, saldo por vencer, transferencia recibida, stockout resuelto.
Loyalty existente
loyalty
Sincronización opcional con programas de puntos de la cadena (sólo lectura).
Registro de pagos externos
payments activation
Webhook de confirmación de pago del ofertante para activar saldos. La plataforma NO procesa el dinero.
API y webhooks
Para cadenas con sistemas propios: API REST documentada con OpenAPI + webhooks firmados
Eventos de webhook previstos
- balance_created · redemption_completed
- redemption_reversed · stockout_reported
- claim_opened · claim_resolved
- offer_accepted · pool_activated
Endpoints POS (carrito mixto)
- POST /pos/redemption/quote
- POST /pos/redemption/confirm
- POST /pos/redemption/reverse
- POST /pos/product-mapping/sync
Ninguna credencial vive en el código ni en el repositorio: todas las claves se inyectan por variables de entorno o secretos del entorno de deploy. El registro de pagos externos sólo confirma activaciones de saldo — la plataforma no procesa dinero entre las partes.