Skip to content
Desarrolladores

API de tarjetas wallet

Una sola API para crear, actualizar y revocar tarjetas de Apple Wallet y Google Wallet con webhooks en tiempo real.

  • API REST y webhooks
  • Apple Wallet + Google Wallet
  • Plantillas, lotes y entorno sandbox
Compatible con:
Apple WalletApple WalletGoogle WalletGoogle Wallet

Explorador de la API REST de Passinstance

Ejemplo ilustrativo

Solicitudes y respuestas de ejemplo. No se envía ninguna llamada a la API.

POST/api/v1/passes
Emite un pase personalizado para Apple Wallet y Google Wallet con enlaces de descarga directos.
curl -X POST https://api.passinstance.com/api/v1/passes \
  -H "X-API-Key: $PASSINSTANCE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "templateId": "tpl_gold_vip_001",
    "serialNumber": "MEM-2026-8819",
    "customFields": {
      "customerName": { "label": "MEMBER", "value": "Jane Doe" },
      "pointsBalance": { "label": "POINTS", "value": "1,450 pts" },
      "tier": { "label": "TIER", "value": "Gold VIP" }
    },
    "barcodeMessage": "PASS-MEM-2026-8819"
  }'
Respuesta de ejemplo
201 Created
{
  "ok": true,
  "data": {
    "id": "pass_9842011a",
    "templateId": "tpl_gold_vip_001",
    "serialNumber": "MEM-2026-8819",
    "status": "active",
    "downloadUrl": "https://api.passinstance.com/api/v1/passes/pass_9842011a/download",
    "googleWalletUrl": "https://pay.google.com/gp/v/save/eyJhbGciOiJSUzI1...",
    "applePassUrl": "https://passinstance.com/p/pass_9842011a.pkpass",
    "createdAt": "2026-08-16T15:25:00Z"
  }
}
Resumen

Passinstance ofrece una API de tarjetas wallet para automatizar todo el ciclo de vida: creación mediante plantillas, actualización de saldos, notificaciones push y revocación para iOS y Android.

Los webhooks notifican a sus sistemas en tiempo real sobre instalaciones, actualizaciones y canjes en el punto de venta.

Capacidades

Todo para desplegar sus tarjetas Wallet en producción

01

Endpoints del ciclo de vida de la tarjeta

Cree, consulte, modifique y anule tarjetas y plantillas con endpoints REST fiables.

02

Webhooks para eventos en directo

Reciba avisos automáticos de instalación, actualización y canje para sincronizar su software.

03

API de tarjetas wallet

Cree, actualice y revoque tarjetas mediante programación con una API REST y webhooks de eventos en tiempo real.

04

Códigos QR y enlaces de descarga

Distribuya tarjetas mediante páginas web alojadas, códigos QR, correo, SMS o TPV — instalación en un toque sin apps.

05

Actualizaciones según la wallet

Actualice los datos mediante la API. Apple Wallet puede mostrar mensajes configurados; Google controla sus alertas integradas.

06

Relevancia por ubicación

Configure ubicaciones para funciones compatibles. La disponibilidad, el momento de visualización y los permisos dependen de la wallet y los ajustes del cliente.

07

Fechas, caducidad y ciclo de vida

Configure fechas de expiración, extienda validez en cada escaneo y gestione el ciclo de vida completo de cada tarjeta.

Preguntas frecuentes

Preguntas frecuentes

¿Qué funciones tiene la API de tarjetas wallet?

Cree, actualice y revoque pases de Apple Wallet y Google Wallet mediante programación. Apple Wallet usa APNs para actualizaciones; Google controla sus alertas integradas. La API también ofrece plantillas y webhooks de eventos.

¿Es una sola API para Apple y Google?

Sí. Una única llamada emite tarjetas compatibles con iPhone y Android.

¿Incluye webhooks?

Sí. Notificaciones instantáneas de altas, cambios y escaneos.

¿Hay entorno de pruebas?

Sí. Dispone de sandbox y claves de desarrollo.

PRUEBE PASES DE PRODUCCIÓN EN SU DISPOSITIVO

Escanee pases reales directamente en Apple Wallet y Google Wallet

Apunte la cámara de su smartphone a cualquier código QR a continuación para instalar un pase verificado al instante. Experimente notificaciones en pantalla de bloqueo e integración nativa sin descargar apps.

Apple WalletGoogle WalletApple Wallet y Google Wallet
Banca privada
Aurelia Private Bank - Private Client Cashback & Concierge
Experiencia en vivo

Prueba el pase en vivo de Aurelia Private Bank

Muestra el cashback en tiempo real y el estado del servicio de conserjería 24/7 en una sucursal o en el punto de venta, sin otra aplicación bancaria.

ClienteAlexander Wright
Cashback€428.50
Cuenta•••• 9104
Abrir pase en el móvil

Pases de demostración interactivos para Apple Wallet y Google Wallet

Cree esta experiencia Wallet en su espacio de trabajo

Comience gratis conservando el contexto de esta demostración para recibir la plantilla adecuada durante la configuración.

Desarrolle con la API de tarjetas wallet

Empiece gratis, obtenga sus claves de API y automatice la emisión de tarjetas wallet.