Norfidelity
Acceso Comercio Empezar Ahora
Documentación

Integración técnica de Norfidelity

Referencia para equipos técnicos que necesitan conectar Wallet passes, POS, campañas y eventos de fidelidad con sistemas existentes.

Agendar revisión técnica
Implementación técnica

Documentación técnica para integradores

Conecte Norfidelity a su operación actual mediante API, webhooks o flujos compatibles con POS. Esta guía resume la arquitectura, los eventos clave y los requisitos para salir a producción.

POS / eCommerce Compra, cliente y ticket
API Norfidelity Pases, puntos y reglas
Motor IA Riesgo, segmento y oferta
Wallet Pass Saldo, QR y push

Arquitectura Wallet

Modelo de integración para crear pases, actualizar saldo en tiempo real y sincronizar cambios con Apple Wallet y Google Wallet.

  • Plantillas por marca y sucursal
  • Identificador único por cliente
  • QR dinámico para canje seguro

API y Webhooks

Endpoints REST y eventos salientes para automatizar altas, movimientos, beneficios y redenciones desde sistemas externos.

  • POST /passes
  • PATCH /passes/{id}
  • coupon.redeemed

Integración POS

Validación de beneficios por escaneo QR, carga batch o integración directa con el punto de venta para mantener datos consistentes.

  • Validación en caja
  • Sincronización de tickets
  • Reglas por sucursal

Seguridad operativa

Controles para proteger datos de clientes, evitar fraude en canjes y mantener trazabilidad de eventos comerciales.

  • API keys por ambiente
  • HTTPS y tokens firmados
  • Auditoría de redenciones

Referencia rápida

Los equipos técnicos pueden validar la integración por módulos: creación de pase, actualización de saldo, redención y eventos de campaña.

Endpoints principales

POST /passesCrear un pase Wallet para un cliente.
PATCH /passes/{id}Actualizar saldo, puntos o metadata.
POST /redemptionsRegistrar un canje desde POS o eCommerce.
POST /events/purchaseSincronizar ticket y comportamiento de compra.

Webhooks disponibles

pass.createdAlta correcta de pase digital.
pass.updatedCambio de saldo o beneficio.
coupon.redeemedCanje confirmado en caja.
customer.inactiveCliente elegible para recuperación.

Ambientes

SandboxDatos ficticios, pruebas de QR y flujos de redención.
ProducciónAPI keys activas, plantillas verificadas y reglas finales.
Webhook signingValidación de origen mediante firma por evento.

Checklist de salida a producción

Antes de activar un comercio, validamos marca, reglas de fidelidad, eventos POS, consentimiento de contacto, seguridad de webhooks y pruebas de canje.

Agendar revisión técnica