Usar la API de Passtastic
Qué te permite hacer la API
La API de Passtastic conecta tus propios sistemas — un POS personalizado, un CRM, una app interna — directamente con tu programa de fidelidad. Con ella puedes:
- Inscribir clientes y emitir tarjetas de wallet desde tu propio flujo de registro
- Añadir sellos o puntos, y consultar el saldo de un cliente, desde tu propia caja o back office
- Recibir notificaciones en tiempo real con webhooks — en lugar de consultar constantemente, Passtastic envía un evento a tu sistema en el momento en que ocurre algo (un cliente se inscribe, se canjea una recompensa, y más)
- Reutilizar los clientes que ya tienes — si alguien que tu sistema inscribe ya se registró a través de tu página de registro, Passtastic lo reconoce por correo electrónico o teléfono y añade tu referencia a la tarjeta que ya tiene, en lugar de emitir una segunda
Esto es para negocios que crean una integración personalizada. Si solo quieres una conexión ya lista, consulta Conecta Square POS o Sistemas POS e integraciones — sin necesidad de código.
El acceso a la API depende de tu plan. Si no está incluido, verás una oferta de mejora al abrir API y webhooks en Ajustes.
Crea una clave de API
1. Abre Ajustes, luego API y webhooks (en Negocio).
2. En la pestaña Claves de API, haz clic en Crear clave.
3. Ponle un nombre a la clave para saber luego para qué es (p. ej. "CRM de producción").
4. Tu nueva clave se muestra una sola vez, en la ventana Tu nueva clave de API. Cópiala ahora — no podrás volver a verla. Haz clic en Copiar, o en Mostrar para revelarla primero.
Trata esta clave como una contraseña. Cualquiera que la tenga puede actuar en tu cuenta a través de la API.
5. Guarda la clave de forma segura en tu propio sistema (una variable de entorno, un gestor de secretos) y envíala como encabezado de autenticación en cada solicitud — el formato exacto está en la referencia técnica más abajo.
Solo los administradores pueden crear o revocar claves de API.
¿Perdiste una clave o crees que se filtró?
Las claves no se vuelven a mostrar después de crearlas. Si perdiste una, o crees que se ha expuesto, abre Claves de API y haz clic en Revocar — esto la detiene de inmediato — y luego crea una nueva y actualiza tu integración.
Configura un webhook
Los webhooks hacen que tu sistema reaccione en el momento en que algo pasa en Passtastic, sin que tengas que estar consultando la API todo el tiempo.
1. En la pestaña Webhooks, haz clic en Añadir endpoint.
2. Introduce la URL del endpoint — la dirección de tu propio sistema que recibirá el evento (p. ej. `https://tu-sistema.com/hook`).
3. En Eventos, elige cuáles quieres recibir:
- Cliente inscrito
- Saldo actualizado
- Nivel cambiado
- Recompensa canjeada
4. Guarda. Tu secreto de firma se muestra una sola vez, en la ventana Secreto de firma — cópialo ahora. Úsalo para comprobar que una solicitud de webhook realmente viene de Passtastic (la referencia técnica explica cómo verificar la firma).
Solo los administradores pueden crear o editar webhooks.
Cada endpoint de webhook muestra sus entregas recientes, para que puedas comprobar si una llamada tuvo éxito o falló, y reintentar una entrega fallida en cuanto tu sistema vuelva a estar disponible, sin esperar al siguiente evento.
Editar o desactivar un webhook
Abre el endpoint y haz clic en Editar para cambiar su URL o eventos, o pon su estado en Desactivado para pausar las entregas sin eliminarlo. Haz clic en Eliminar para quitarlo definitivamente.
Dónde encontrar la referencia técnica completa
Esta guía cubre la parte del panel — crear claves y webhooks. Para endpoints, formatos de solicitud/respuesta, encabezados de autenticación, códigos de error y ejemplos de código, consulta la documentación de la API completa. También puedes acceder a ella en cualquier momento desde el enlace Leer la documentación de la API en la parte superior de la página API y webhooks.