# Documentación de StampyWallet

> La documentación de StampyWallet, la tarjeta de fidelidad en Apple Wallet y Google Wallet para comercios de proximidad: la guía del comerciante, el servidor MCP y sus herramientas, la API y los webhooks, y el skill «tarjetas bonitas».

Cada enlace lleva a la versión Markdown de la página. La misma página se obtiene también pidiendo su dirección normal con la cabecera `Accept: text/markdown`.

Toda la documentación en un solo archivo: [llms-full.txt](https://stampywallet.com/es/docs/llms-full.txt).
El producto, los precios, las funcionalidades y el resto del sitio: [llms.txt](https://stampywallet.com/llms.txt).

## Guía

### Primeros pasos

- [Bienvenido a la documentación de StampyWallet](https://stampywallet.com/es/docs/index.md): StampyWallet es una tarjeta de fidelidad en Apple Wallet y Google Wallet, sin aplicación. Aquí tienes todo lo necesario para crearla, escanearla en el mostrador y gestionarla desde un asistente de IA o tu TPV.
- [Crear tu tarjeta en 5 minutos](https://stampywallet.com/es/docs/guia/crear-tu-tarjeta.md): Abrir tu cuenta, elegir tu tipo de tarjeta, personalizarla, probarla en tu móvil e imprimir el cartel del mostrador.
- [Los tipos de tarjeta](https://stampywallet.com/es/docs/guia/tipos-de-tarjeta.md): Una tarjeta de StampyWallet funciona según uno de tres modos, sellos, varias recompensas (niveles) o puntos, y cada modo se presenta en varias formas.

### En el mostrador

- [Escanear una tarjeta en el mostrador](https://stampywallet.com/es/docs/guia/escanear.md): Poner un sello o puntos, entregar una recompensa, deshacer un error, encontrar a un cliente sin cámara y seguir sin conexión.
- [Tu equipo](https://stampywallet.com/es/docs/guia/equipo.md): Invitar a tus empleados y encargados, lo que puede hacer cada rol y seguir los sellos que pone cada uno. Equipo ilimitado en todos los planes.

### Hacer que vuelvan

- [Mensajes y notificaciones](https://stampywallet.com/es/docs/guia/mensajes.md): Escribir a tus clientes en la pantalla de bloqueo de su móvil, dirigirte a un grupo, programar un envío y dejar que los recordatorios, el aviso a los clientes perdidos y el cumpleaños salgan solos.
- [Tarjetas regalo y bonos](https://stampywallet.com/es/docs/guia/tarjetas-regalo-y-bonos.md): Vender tarjetas regalo y bonos prepagados en el mostrador, enviarlos al Wallet y descontarlos al escanear.
- [Reseñas de Google](https://stampywallet.com/es/docs/guia/resenas-google.md): Pedir una reseña de Google a cada cliente en el momento adecuado, con un enlace directo a tu ficha, sin filtrar ni recompensar, siguiendo las reglas de Google.

## MCP e IA

### Conectar

- [Conectar un asistente de IA](https://stampywallet.com/es/docs/mcp/conectar.md): El servidor MCP de StampyWallet conecta Claude, ChatGPT, Cursor o un agente con tu tarjeta de fidelidad. Una dirección, ninguna clave, y nada cambia sin tu aprobación.
- [Conectar Claude](https://stampywallet.com/es/docs/mcp/claude.md): Añadir StampyWallet como conector personalizado en Claude (web, escritorio y móvil) y luego conectar tu cuenta.
- [Conectar ChatGPT](https://stampywallet.com/es/docs/mcp/chatgpt.md): Añadir el servidor MCP de StampyWallet como conector en ChatGPT y luego conectar tu cuenta de StampyWallet.
- [Conectar Cursor y los agentes](https://stampywallet.com/es/docs/mcp/cursor.md): Declarar el servidor MCP de StampyWallet en Cursor, Claude Code, VS Code o cualquier agente compatible con MCP.

### Herramientas sin cuenta

- [concevoir_carte](https://stampywallet.com/es/docs/mcp/herramientas/concevoir_carte.md): Concevoir une carte de fidélité
- [simuler_fidelite](https://stampywallet.com/es/docs/mcp/herramientas/simuler_fidelite.md): Simuler le coût d’une carte de fidélité
- [creer_commerce](https://stampywallet.com/es/docs/mcp/herramientas/creer_commerce.md): Mettre la carte de fidélité en service

### Herramientas con cuenta

- [tableau_de_bord](https://stampywallet.com/es/docs/mcp/herramientas/tableau_de_bord.md): Tableau de bord du commerce
- [rentabilite](https://stampywallet.com/es/docs/mcp/herramientas/rentabilite.md): Ce que rapporte la carte
- [meilleurs_moments](https://stampywallet.com/es/docs/mcp/herramientas/meilleurs_moments.md): Meilleurs jours et heures
- [chercher_clients](https://stampywallet.com/es/docs/mcp/herramientas/chercher_clients.md): Chercher des clients
- [fiche_client](https://stampywallet.com/es/docs/mcp/herramientas/fiche_client.md): Fiche d’un client
- [envoyer_message](https://stampywallet.com/es/docs/mcp/herramientas/envoyer_message.md): Envoyer un message aux clients
- [lister_messages_recurrents](https://stampywallet.com/es/docs/mcp/herramientas/lister_messages_recurrents.md): Voir les messages récurrents
- [programmer_message_recurrent](https://stampywallet.com/es/docs/mcp/herramientas/programmer_message_recurrent.md): Programmer un message récurrent
- [modifier_message_recurrent](https://stampywallet.com/es/docs/mcp/herramientas/modifier_message_recurrent.md): Modifier un message récurrent
- [suspendre_message_recurrent](https://stampywallet.com/es/docs/mcp/herramientas/suspendre_message_recurrent.md): Mettre en pause un message récurrent
- [reprendre_message_recurrent](https://stampywallet.com/es/docs/mcp/herramientas/reprendre_message_recurrent.md): Reprendre un message récurrent
- [arreter_message_recurrent](https://stampywallet.com/es/docs/mcp/herramientas/arreter_message_recurrent.md): Arrêter un message récurrent
- [historique_messages](https://stampywallet.com/es/docs/mcp/herramientas/historique_messages.md): Historique des messages
- [regler_automatismes](https://stampywallet.com/es/docs/mcp/herramientas/regler_automatismes.md): Messages automatiques
- [lister_fermetures](https://stampywallet.com/es/docs/mcp/herramientas/lister_fermetures.md): Voir les congés et fermetures
- [ajouter_conges](https://stampywallet.com/es/docs/mcp/herramientas/ajouter_conges.md): Ajouter des congés
- [supprimer_conges](https://stampywallet.com/es/docs/mcp/herramientas/supprimer_conges.md): Supprimer des congés
- [regler_jours_fermes](https://stampywallet.com/es/docs/mcp/herramientas/regler_jours_fermes.md): Régler les jours fermés chaque semaine
- [avis_google](https://stampywallet.com/es/docs/mcp/herramientas/avis_google.md): Avis Google
- [voir_carte](https://stampywallet.com/es/docs/mcp/herramientas/voir_carte.md): Voir ma carte de fidélité
- [modifier_carte](https://stampywallet.com/es/docs/mcp/herramientas/modifier_carte.md): Modifier ma carte de fidélité
- [fiche_commerce](https://stampywallet.com/es/docs/mcp/herramientas/fiche_commerce.md): Fiche du commerce
- [affichette](https://stampywallet.com/es/docs/mcp/herramientas/affichette.md): Affichette et QR code
- [envoyer_affichette](https://stampywallet.com/es/docs/mcp/herramientas/envoyer_affichette.md): Recevoir l’affichette par e-mail
- [lister_equipe](https://stampywallet.com/es/docs/mcp/herramientas/lister_equipe.md): Voir l’équipe
- [inviter_membre](https://stampywallet.com/es/docs/mcp/herramientas/inviter_membre.md): Inviter un membre de l’équipe
- [changer_role_membre](https://stampywallet.com/es/docs/mcp/herramientas/changer_role_membre.md): Changer le rôle d’un membre
- [retirer_membre](https://stampywallet.com/es/docs/mcp/herramientas/retirer_membre.md): Retirer un membre de l’équipe
- [annuler_invitation](https://stampywallet.com/es/docs/mcp/herramientas/annuler_invitation.md): Annuler une invitation

## API y webhooks

### Empezar

- [La API de StampyWallet](https://stampywallet.com/es/docs/api.md): Añade visitas, crea clientes y recibe los eventos de tu tarjeta de fidelidad desde tu TPV, tu web o una herramienta sin código.
- [Autenticación](https://stampywallet.com/es/docs/api/autenticacion.md): Cada llamada a la API lleva una clave secreta sw_live_, creada en Ajustes › Integraciones y mostrada una sola vez. 120 peticiones por minuto y por clave.
- [Errores y reintentos](https://stampywallet.com/es/docs/api/errores.md): El formato de los errores de la API, todos sus códigos y la cabecera Idempotency-Key para reintentar un POST sin riesgo de duplicados.

### Referencia

- [Leer el comercio](https://stampywallet.com/es/docs/api/comercio.md): GET /v1/commerce devuelve la ficha del comercio vinculado a la clave y las reglas de su tarjeta de fidelidad.
- [Crear un cliente](https://stampywallet.com/es/docs/api/crear-cliente.md): POST /v1/clients registra a un cliente en el programa de fidelidad y devuelve el enlace de su tarjeta, para enviárselo por SMS o correo.
- [Buscar un cliente](https://stampywallet.com/es/docs/api/buscar-clientes.md): GET /v1/clients encuentra a un cliente por su teléfono, su correo o el código de su tarjeta.
- [Leer un cliente](https://stampywallet.com/es/docs/api/leer-cliente.md): GET /v1/clients/:id devuelve un cliente y el estado de su tarjeta de fidelidad, sellos, puntos y recompensas por entregar.
- [Añadir una visita](https://stampywallet.com/es/docs/api/anadir-visita.md): POST /v1/passages añade un sello o puntos a la tarjeta de un cliente desde tu TPV, e indica si se ha conseguido una recompensa.
- [Anular una visita](https://stampywallet.com/es/docs/api/anular-visita.md): DELETE /v1/passages/:id retira la última visita de un cliente, por ejemplo tras un ticket anulado o reembolsado en caja.
- [Entregar una recompensa](https://stampywallet.com/es/docs/api/dar-recompensa.md): POST /v1/recompenses marca como entregada una recompensa ganada por un cliente, desde tu TPV.

### Webhooks

- [Webhooks](https://stampywallet.com/es/docs/api/webhooks.md): Recibe una llamada HTTP firmada en tu servidor, Zapier, Make o n8n en cada visita, recompensa o tarjeta nueva, y verifica su firma HMAC.
- [Lista de eventos](https://stampywallet.com/es/docs/api/eventos.md): Los nueve eventos que envían los webhooks de StampyWallet, cuándo salen y el contenido exacto de su campo donnees.

### TPV

- [Recibir los eventos de tu TPV](https://stampywallet.com/es/docs/api/entrantes.md): POST /v1/entrants/:jeton recibe las ventas de Square, Shopify, SumUp, Zettle o de cualquier herramienta, y añade la visita al cliente correcto.
- [Conectar tu TPV](https://stampywallet.com/es/docs/api/conectar-tu-tpv.md): Los ajustes paso a paso para que Square, Shopify, SumUp, Zettle, Zapier, Make o n8n añadan un sello en cada venta, sin desarrollador.

## skill.md

- [Instalar el skill «tarjetas bonitas»](https://stampywallet.com/es/docs/skill/index.md): Un archivo Markdown que enseña a tu asistente de IA a diseñar las tarjetas de fidelidad de un comercio como lo hacemos nosotros: sus imágenes reales primero, las catorce formas de tarjeta, iconos que cuentan la recompensa y una revisión antes de enseñarlas.
- [Lo que hace el skill](https://stampywallet.com/es/docs/skill/metodo.md): Las catorce formas de tarjeta, las imágenes reales primero, los iconos con licencia cuando las fotos no encajan y la revisión de cada tarjeta antes de enseñarla.