Tarjetas de puntos y sellos en Apple Wallet y Google Wallet por API
28 de octubre de 2026 · Equipo Zoosial
Con la API de Wallet de Zoosial creas un programa de puntos, sellos o cashback con tu logo y colores, emites una tarjeta por cliente y se la entregas con un enlace o QR para que la agregue a Apple Wallet o Google Wallet. Cada compra se registra por API y el saldo se actualiza solo en el teléfono, sin que el cliente instale una app. Hoy está disponible por invitación: solo para cuentas habilitadas por Zoosial.
Cómo se organiza
Hay dos piezas. Un Program es el diseño de tu tarjeta: una marca y un tipo de recompensa (cashback, points o stamps). Un Pass es la tarjeta ya emitida para un cliente concreto, con su propio saldo. Google Wallet usa el mismo Program, con los mismos colores y logo.
Paso 1: crea el programa
POST /wallet/programs
{ "name": "Mi cafetería", "type": "stamps",
"primaryColor": "#3E2723", "logoUrl": "https://…/logo.png" }
Solo name es obligatorio. Puedes personalizar colores, degradado, textos de la tarjeta, mensaje en el reverso y formato del valor (número o dinero). Con PATCH /wallet/programs/:id editas el diseño y las tarjetas ya instaladas se refrescan.
Paso 2: emite y entrega la tarjeta
POST /wallet/passes
{ "programId": "prog_…", "customerId": "mi-id-de-cliente", "customerName": "…" }
La respuesta trae appleUrl, el enlace completo para «Agregar a Apple Wallet», y googleUrl, el de «Guardar en Google Wallet» cuando Google Wallet está activo para tu cuenta (si no, viene en null). No hay endpoint de QR: appleUrl es una URL normal, así que generas el QR en tu app con cualquier librería. El cliente no necesita cuenta de Zoosial.
Paso 3: registra las compras
POST /wallet/passes/:id/transactions
{ "type": "points", "amount": <cantidad>, "reason": "compra en mostrador" }
Es un historial, no solo un saldo: cada movimiento queda auditado con su razón y referencia. Un monto negativo descuenta o redime, y si deja el saldo bajo cero responde error. En iPhone, el pase se refresca solo con el protocolo PassKit de Apple, sin que el cliente vuelva a escanear nada. Consulta el historial con GET /wallet/passes/:id/transactions.
Tu marca y tu certificado de Apple
Por defecto el programa usa el certificado de Zoosial y queda activo de inmediato. Si quieres tu propio Pass Type ID, creas el programa con certificateMode:"own", generas un CSR por API, lo llevas a tu cuenta de Apple Developer y subes el certificado que te den. Por ahora ese paso se hace solo por API; no hay pantalla.
Eventos y precio
Puedes suscribirte por webhook a pass.created, pass.updated, pass.deleted y program.apple.connected. El precio se acuerda al activar tu cuenta: escribe a hola@zoosial.com.
Preguntas frecuentes
¿Cómo creo una tarjeta de lealtad en Apple Wallet?
Creas un programa con POST /wallet/programs y emites una tarjeta por cliente con POST /wallet/passes. La respuesta trae el enlace para agregarla a Apple Wallet, que puedes mandar por mensaje o convertir en QR.
¿Funciona en iPhone y Android?
Sí: Apple Wallet en iPhone y Google Wallet en Android. El enlace de Google Wallet aparece cuando está activo para tu cuenta.
¿El cliente necesita instalar una app?
No. Agrega la tarjeta desde un enlace o QR y vive en el Wallet de su teléfono.
¿Cómo activo Wallet en mi cuenta?
Hoy se abre por invitación. Escribe a hola@zoosial.com; mientras no esté habilitada, la API responde 403 wallet_no_disponible.
Más en Wallet de lealtad, la guía de Wallet y llms.txt. Para crear tu cuenta, regístrate aquí.