Conectar tu TPV
Los ajustes paso a paso para que Square, Shopify, SumUp, Zettle, Zapier, Make o n8n añadan un sello en cada venta, sin desarrollador.
Conectar tu TPV es darle una dirección de StampyWallet a la que llamar en cada venta pagada. La visita se añade entonces sola a la tarjeta del cliente, encontrado por su teléfono o su correo. No hace falta nada para empezar: el escaneo en el mostrador basta, y el TPV es un extra, sobre todo para una tarjeta de puntos.
Nota : el TPV solo conoce al cliente si tiene su teléfono o su correo (ficha de cliente, ticket enviado por correo, pedido en línea), y el cliente ya debe tener su tarjeta de StampyWallet: un TPV nunca crea clientes. Una venta anónima se ignora: para ella, el escaneo en el mostrador sigue siendo lo adecuado.
Primero, en StampyWallet
- Abre Ajustes › Integraciones y elige Recibir las ventas de un TPV.
- Elige el TPV (Square, Shopify, SumUp, Zettle, u «Otro» para el formato genérico).
- Copia la dirección creada, con la forma
https://app.stampywallet.com/v1/entrants/ent_….
Luego, en tu TPV
- Abre el Square Developer Dashboard, crea una aplicación (o abre la tuya) y luego Webhooks › Subscriptions › Add subscription.
- Pega la dirección de StampyWallet como Notification URL y marca los eventos
payment.createdypayment.updated. - Copia la Signature key de la suscripción y pégala en Ajustes › Integraciones.
- Solo cuentan los pagos que pasan a
COMPLETED.
- En la administración de Shopify: Configuración › Notificaciones › Webhooks › Crear webhook.
- Evento: Pago de pedido (
orders/paid), formato JSON, dirección: la de StampyWallet. - Copia el secreto que aparece bajo la lista de webhooks («Tus webhooks se firmarán con…») y pégalo en Ajustes › Integraciones.
- El cliente se encuentra por el correo o el teléfono del pedido.
- SumUp envía sus notificaciones de transacción a la dirección indicada por una aplicación vinculada a tu cuenta. Desde tu espacio de desarrollador de SumUp, declara la dirección de StampyWallet para las transacciones correctas.
- Pega en Ajustes › Integraciones el secreto de firma proporcionado, si lo hay.
- Beta: escríbenos si no llega una venta, lo revisamos contigo.
- Zettle (PayPal) envía sus eventos mediante su API de webhooks: crea una suscripción al evento de compra creada (
PurchaseCreated) hacia la dirección de StampyWallet. - Pega en Ajustes › Integraciones la clave de firma de la suscripción.
- Beta: escríbenos si no llega una venta.
Sin código: Zapier, Make, n8n
En los dos sentidos: una herramienta sin código puede enviar a StampyWallet las ventas de un TPV que conozca, o recibir los eventos de StampyWallet para rellenar una hoja de cálculo, un CRM o una lista de correo.
Enviar una venta a StampyWallet
- Disparador: tu TPV o tu tienda («New Payment», «New Order»…).
- Acción: Webhooks by Zapier › POST, URL: la dirección «Otro» (formato genérico), tipo de datos: JSON.
- Cuerpo:
{"client": {"telephone": "…"}, "montant": …, "reference": "…"}(oemailen lugar detelephone), siendo la referencia el número de la venta.
Recibir los eventos de StampyWallet
- Disparador: Webhooks by Zapier › Catch Hook. Copia la dirección del hook.
- Pégala como punto de recepción en Ajustes › Integraciones (Webhooks) y haz clic en «Enviar una prueba».
Enviar una venta a StampyWallet
- Módulo de tu TPV como disparador y luego módulo HTTP › Make a request.
- Método
POST, URL: la dirección «Otro», cuerpo JSON{"client": {"telephone": "…"}, "montant": …, "reference": "…"}, comoPOST /v1/passages.
Recibir los eventos de StampyWallet
- Módulo Webhooks › Custom webhook, copia la dirección.
- Pégala como punto de recepción en Ajustes › Integraciones y luego «Enviar una prueba» para que Make aprenda la estructura.
Enviar una venta a StampyWallet
- Nodo de tu TPV como disparador y luego nodo HTTP Request.
- Método
POST, URL: la dirección «Otro», cuerpo JSON{"client": {"telephone": "…"}, "montant": …, "reference": "…"}, comoPOST /v1/passages.
Recibir los eventos de StampyWallet
- Nodo Webhook (método POST), copia la dirección de producción.
- Pégala como punto de recepción en Ajustes › Integraciones. Para verificar la firma, añade un nodo Code con el ejemplo de Node.js de la página Webhooks.
Otro TPV
Si tu TPV sabe llamar a una dirección en cada venta (muchos lo hacen, con el nombre de «webhook» o «notificación»), usa la dirección «Otro» y el formato genérico. Si no, escríbenos desde la página de contacto: lo revisamos contigo.
Preguntas frecuentes
¿Funciona con mi TPV?
Los ajustes están listos para Square, Shopify, SumUp y Zettle. Cualquier otro TPV que sepa llamar a una dirección en cada venta pasa por el formato genérico, y un TPV que Zapier, Make o n8n conozcan puede pasar por ellos. Si no, escríbenos: lo miramos contigo.
¿Necesito un desarrollador?
No. Copias una dirección en StampyWallet, la pegas en tu TPV y luego pegas en StampyWallet el secreto de firma que te da el TPV, si lo hay.
¿Mi cliente tiene que tener ya su tarjeta?
Sí. Un TPV nunca crea clientes: encuentra la tarjeta por el teléfono o el correo del cliente. Una venta anónima se ignora, y entonces el escaneo en el mostrador sigue siendo el gesto correcto.
¿Una venta puede contar dos veces?
No. Cada venta lleva su referencia: si el TPV reintenta después de un corte, la visita no se añade una segunda vez.
¿La conexión del TPV está incluida en mi suscripción?
Forma parte del plan Crecimiento, a 40 € sin IVA al mes, y está abierta durante la prueba gratuita de 30 días. No está incluida en el plan Esencial.
Actualizado el