Skip to content
Guía del Centro de ayuda · Certificados y credencialesFase de incorporación 2
4 min de lecturaVerificado 2026-11-16

Configuración de Google Wallet

Diferencia entre Issuer ID gestionado o propio de Google Wallet y ajustes específicos de Android.

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 ampliado
Elementos clave de la interfaz

Editor — Tipo de pase y variante (Ampliado)

Elige la estructura base (Cupón, Tarjeta de fidelidad, Entrada, Genérico o Embarque) y su variante de diseño.

Descripción general: configuración administrada frente a emisor personalizado de Google Wallet

A diferencia del requisito de certificado por comercio de Apple Wallet, Passinstance incluye de serie una Infraestructura administrada de emisor de Google Wallet para que pueda publicar y distribuir pases en Android inmediatamente durante la incorporación (PUT /api/v1/onboarding/wallet-setup). Para marcas empresariales que necesitan titularidad sobre su propio Issuer ID en Google Pay & Wallet Console o claves personalizadas sin contacto de Google Smart Tap, Passinstance también admite vincular una cuenta de servicio dedicada de Google Cloud (POST /api/v1/google-wallet/setup).

FLUJO DE ARQUITECTURA
ARQUITECTURA INTERACTIVA
CONFIGURACIÓN DE EMISOR Y CUENTA DE SERVICIO GOOGLE WALLET
ETAPA 01 OPCIÓN A: EMISOR ADMINISTRADO POR PASSINSTANCE (POR DEFECTO)
Sin configuración previa en Google Cloud
Activado automáticamente en incorporación (PUT/api/v1/onboarding/wallet-setup)
Passinstance firma Save JWT y gestiona llamadas REST walletobjects por usted
ETAPA 02 OPCIÓN B: CONFIGURACIÓN DE EMISOR EMPRESARIAL PERSONALIZADO
1
Google Pay & Wallet Console (pay.google.com/business/console)
Copie el issuerId numérico de 19 dígitos (ej. 3388000000022194812)
Configure el collectorId Smart Tap (si usa canje NFC sin contacto)
2
Google Cloud Console (console.cloud.google.com)
Habilite "Google Wallet API" (walletobjects.googleapis.com)
Cree Service Account y exporte clave JSON (private_key, client_email)
3
Autorice la cuenta de servicio en Google Pay & Wallet Console
Invite a client_email con acceso Developer / Admin
4
Aprovisione en Passinstance (POST/api/v1/google-wallet/setup)
Cifra el JSON en encrypted storage y verifica conectividad con la API

Requisitos previos: Al configurar un Google Wallet Issuer ID personalizado, debe invitar al correo client_email de la cuenta de servicio de Google Cloud dentro de Google Pay & Wallet Business Console -> Users con permisos de Developer. Sin este vínculo IAM, la API walletobjects de Google devolverá 403 Forbidden cuando Passinstance intente crear Clases u Objetos.

Comparativa entre el modo de emisor administrado y personalizado

CapacidadEmisor administrado por PassinstanceIssuer ID empresarial personalizado
Tiempo de configuraciónInstantáneo (0 minutos)~15 minutos (Google Cloud + Business Console)
Nombre de marca y logotipo en tarjetaTotalmente personalizado por plantilla (issuerName, programLogo)Totalmente personalizado por plantilla (issuerName, programLogo)
Acceso a Google Pay & Wallet ConsoleAdministrado por PassinstanceAcceso directo a su propia Google Business Console
Google Smart Tap NFC (NFC_SMART_TAP)Utiliza la configuración de espacio de trabajo y lectorAdmite su propio smartTapMerchantId y collectorId personalizados
Webhook de callback (/api/v1/wallet/callback)Preconfigurado automáticamenteConfigurado automáticamente al crear la clase

API de configuración y activación de plantillas de Google Wallet (Google Wallet Setup API)

Todos los endpoints de aprovisionamiento de emisores y plantillas de Google Wallet residen bajo /api/v1/google-wallet:

MétodoRuta del endpointPermiso requeridoDescripción
POST/api/v1/google-wallet/setupwallet:manage, certificates:manageAprovisiona una cuenta emisora de Google Wallet y un ID de colector Smart Tap opcional utilizando los datos de empresa del espacio de trabajo.
GET/api/v1/google-wallet/statuswallet:read / wallet:manageDevuelve { isConfigured, collectorId } indicando si Google Wallet y Smart Tap están aprovisionados.
POST/api/v1/google-wallet/repair-callbackswallet:manage, certificates:manageResincroniza las URL de webhook /api/v1/wallet/callback faltantes en las clases publicadas de Google Wallet.
POST/api/v1/google-wallet/templates/:templateId/activatewallet:manage, certificates:manageActiva el aprovisionamiento de clases de Google Wallet para una plantilla específica.
POST/api/v1/google-wallet/templates/:templateId/deactivatewallet:manage, certificates:manageDesactiva la compatibilidad con Google Wallet para una plantilla específica.
GET/api/v1/google-wallet/templates/:templateId/statuswallet:manage, certificates:readDevuelve { isEnabled, issuerId } para la plantilla de destino.

Ejemplo: inicializar la configuración del emisor de Google Wallet

BASH
POST /api/v1/google-wallet/setup
X-API-Key: <API_KEY>

Respuesta (201 Created):

JSON
{
  "issuerId": "3388000000022194812",
  "googlePayAccount": {
    "accountIdentifier": "3388000000022194812",
    "collectorId": "50992104"
  },
  "smartTapMerchantData": {
    "smartTapMerchantId": "50992104"
  }
}

Consultar después el estado mediante GET /api/v1/google-wallet/status devuelve { "isConfigured": true, "collectorId": "50992104" }, y los pases individuales exponen googleWalletTypeSource (Google Wallet source type: INITIAL_CREATION | MIGRATION | MANUAL_REGENERATION).

Buenas prácticas durante la configuración de plantillas

  1. 1
    Elegir la categoría coincidente en Google Wallet: Dentro de Editar plantilla -> Tipos de pase, haga coincidir su programa con Fidelización (LoyaltyClass), Oferta (OfferClass), Tarjeta regalo (GiftCardClass), Entrada de evento (EventTicketClass) o Pase genérico (GenericClass): las clases de Google Wallet no pueden cambiar de tipo de recurso una vez publicadas.
  2. 2
    Probar explícitamente la vista previa de Android: Alterne entre Apple Wallet y Google Wallet en el panel de vista previa en vivo, ya que las proporciones de imagen (banner ancho androidBackground frente al recorte cuadrado googlePayLogo) y las reglas de truncado de campos difieren entre ambas plataformas.
  3. 3
    Usar anulaciones para Android: Defina etiquetas y valores específicos para Android desde el Inspector cuando una ranura de diseño de Apple no tenga correspondencia 1:1 en Android.

Consulte Google Wallet y Google Smart Tap para especificaciones de clases, objetos y NFC.

¿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.