Skip to content
Guía del Centro de ayuda · Inicio rápidoFase de incorporación 2
4 min de lecturaVerificado 2026-11-16

Crea tu primer pase Wallet

Diseña una plantilla, asigna una mecánica, enlaza campos dinámicos, publica con seguridad y pruébalo en tu móvil.

En esta guía

Recorridos visuales interactivos

Abrir en la guía de 6 fases

Inspecciona las pantallas reales del panel y las anotaciones ampliadas de esta guía.

Enfoque de interfaz ampliado1 / 2
Elementos clave de la interfaz

Directorio de plantillas y barra de adopción (Ampliado)

Filtra plantillas, controla Instalados vs. Eliminados por plantilla y abre vistas previas, Editor Visual o creación unitaria.

Descripción general

Crear su primer pase de monedero implica configurar una plantilla visual reutilizable (Template), vincular mecánicas de negocio interactivas, ejecutar una comprobación de riesgos previa a la publicación y emitir un registro concreto Pass que pueda instalarse en dispositivos iOS y Android.

FLUJO DE ARQUITECTURA
ARQUITECTURA INTERACTIVA
CREACIÓN E INSTALACIÓN DEL PRIMER PASE
ETAPA 01
1
DISEÑO DE LA PLANTILLA (POST/api/v1/templates)
Elegir pass type (storeCard, coupon, eventTicket, membership)
Configurar colores (rgb(r,g,b) Apple, #RRGGBB Google) y recursos
Vincular pass mechanic (STAMP_CARD_ADD, LOYALTY_PROGRAM, PREPAID_CARD)
ETAPA 02
2
VERIFICACIÓN DE RIESGO Y PUBLICACIÓN (POST/api/v1/templates/:id/publish)
Evaluar GET/api/v1/templates/:id/publish-risk-check
Promover la revisión de rowKind = DRAFT a rowKind = PRODUCTION
ETAPA 03
3
EMISIÓN DEL PASE E INSTALACIÓN EN WALLET (POST/api/v1/passes)
Cabecera opcional Idempotency-Key (idempotencyKey) y externalId
Rellenar attributes structured JSON (memberName, points, barcodeValue)
Entregar URL inteligente (/p/:passId / /d/:slug)Instalar iOS/Android

Hitos de creación paso a paso

Siga este flujo de trabajo en Passinstance Dashboard (Plantillas -> Crear plantilla en /templates/new) o mediante la API para desarrolladores:

  1. 1
    Seleccionar la geometría del diseño (pass type): Elija uno de los formatos de pase compatibles:

- storeCard: Tarjetas de fidelidad, tarjetas de sellos y tarjetas regalo. - coupon: Vales promocionales de un solo uso y cupones de descuento. - eventTicket / boardingPass: Conciertos, eventos deportivos, festivales, conferencias o tarjetas de embarque aéreas y ferroviarias. - membership / generic / posterGeneric / studentId / businessCard: Carnés de socio, tarjetas póster WWDC, credenciales de empleados o estudiantes y tarjetas de visita digitales.

  1. 2
    Identidad visual, colores y recursos:

- Formato de colores: Apple Wallet exige estrictamente cadenas rgb(r, g, b) (sin canal alfa). Google Wallet acepta hexadecimal #RRGGBB. El selector de color del panel convierte los valores automáticamente y advierte si el contraste WCAG es bajo. - Ranuras de recursos (image asset slot): Suba imágenes en alta resolución en las 13 ranuras compatibles (logo, primaryLogo, secondaryLogo, icon, googlePayLogo, strip, background, thumbnail, artwork, venueMap, footer, androidBackground, androidLogo).

  1. 3
    Vincular una mecánica interactiva al pase:

- Elija un motor de reglas (mechanic type): STAMP_CARD_ADD, STAMP_CARD_DEDUCT, LOYALTY_PROGRAM, PREPAID_CARD, VALID_ONCE_PER_DAY o RENEW_EXPIRATION.

  1. 4
    Definir zonas de campos dinámicos (field placement type):

- Coloque campos en HEADER, PRIMARY, SECONDARY, AUXILIARY, BACK, ADDITIONALINFO o FOOTER. - Use tokens dinámicos entre llaves como {memberName}, {pointsBalance} o {expirationDate}. - Añada cadenas changeMessage de Apple que contengan %@ (por ejemplo, "Puntos actualizados: %@") para activar notificaciones push nativas en la pantalla de bloqueo de iOS.

  1. 5
    Análisis de riesgo previo a la publicación y publicación:

- El panel evalúa GET /api/v1/templates/:id/publish-risk-check para detectar cambios críticos que podrían sobrescribir campos de pases ya emitidos. - Haga clic en Guardar y publicar (POST /api/v1/templates/:id/publish) para promover la revisión DRAFT a la fila base PRODUCTION.

  1. 6
    Generar e instalar un pase de prueba:

- Haga clic en Crear pase en el resumen de la plantilla (/templates/:id/overview) o envíe una solicitud REST a POST /api/v1/passes. La creación del pase invoca automáticamente resolvePassCreationTemplateId para vincular el nuevo pase a la fila base canónica de la plantilla.

Listado de plantillas y acciones rápidas de creación
Listado de plantillas y acciones rápidas de creación

Generación programática de pases y verificación

Los desarrolladores pueden omitir el panel y emitir pases de monedero personalizados directamente desde sistemas backend o CRM mediante POST /api/v1/passes (request payload). Incluya Idempotency-Key para reintentos seguros y externalId para la correlación con el CRM, y opcionalmente añada ?includePassSource=apple|google para recibir directamente en la respuesta los artefactos fuente del monedero:

Solicitud HTTP

POST /api/v1/passes?includePassSource=google
Cabeceras
X-API-Key <API_KEY>
Content-Type application/json
Idempotency-Key order-94021-pass-init
JSON
{
  "templateId": "tmpl_9a8b7c6d5e4f",
  "externalId": "cust_100248",
  "attributes": {
    "memberName": "Elena Rostova",
    "memberNumber": "MB-94021",
    "points": "150"
  },
  "barcodeValue": "PI-MB-94021-SECURE",
  "barcodeAltText": "MB-94021",
  "expirationDate": "2027-12-31 23:59"
}

Respuesta HTTP (201 Created)

JSON
{
  "success": true,
  "data": {
    "id": "pass_1a2b3c4d5e6f",
    "templateId": "tmpl_9a8b7c6d5e4f",
    "serialNumber": "PI-789042-XY",
    "externalId": "cust_100248",
    "bundleId": null,
    "status": "ACTIVE",
    "lifecycleStatus": "ACTIVE",
    "walletVoidStatus": "NONE",
    "appleArtifactStatus": "NOT_GENERATED",
    "googleArtifactStatus": "READY",
    "downloadUrl": "https://app.passinstance.com/d/elena-rostova-94021",
    "passAccessUrl": "https://app.passinstance.com/p/pass_1a2b3c4d5e6f",
    "passSource": {
      "platform": "google",
      "saveUrl": "https://pay.google.com/gp/v/save/eyJhbGciOiJSUzI1NiIsInR5cCI6IkpXVCJ9..."
    },
    "createdAt": "2026-11-15T12:00:00Z"
  },
  "description": "Pass created successfully",
  "errors": [],
  "statusCode": 201
}

Pruebas con pases de muestra en Sandbox

Durante la evaluación y las pruebas iniciales, puede generar un pase de muestra instantáneo sin introducir registros completos de clientes:

  1. 1
    Llame a POST /api/v1/onboarding/sample-pass o haga clic en Probar pase de muestra en el paso /onboarding/try-pass del asistente.
  2. 2
    El servidor crea un pase efímero y expone el endpoint público de muestra:
GET /api/v1/onboarding/sample-pass/public/:sessionId
  1. 3
    Escanee el código QR mostrado con la cámara de un iPhone para iniciar la instalación nativa en Apple Wallet, o abra el enlace en Android para probar Google Wallet.
  2. 4
    Abra el Escáner (/scanner) en Passinstance Dashboard o empareje la aplicación móvil Passinstance Scanner mediante POST /api/v1/scanner-keys/from-link y escanee el pase instalado para verificar los eventos de escaneo en directo y las notificaciones push instantáneas.

Importante: Pruebe siempre su pase recién publicado en dispositivos iOS (Apple Wallet) y Android (Google Wallet) para comprobar el contraste de colores, el truncado de texto en los campos y la fiabilidad de lectura del código de barras antes de lanzar campañas de distribución a clientes.

¿Listo para empezar? Inicie la Fase 2: Diseñar su pase o descubra cómo Crear pases de monedero con IA.

Documentación de producto y API relacionada

¿Listo para lanzar su primer programa de tarjetas Wallet?

Cree su espacio de trabajo, configure su plantilla y pruebe una tarjeta real en Apple Wallet y Google Wallet antes de escalar.