Skip to content
Volver al blog

Cómo crear un pase Google Wallet: Guía de integración

Google Wallet API, tokens JWT firmados y clases de pases genéricos.

Passinstance Team
Passinstance Team

Wallet pass platform team

2026-08-163 min de lectura
Imagen de portada para Cómo crear un pase Google Wallet: Guía de integración

Google Wallet ofrece a los usuarios de Android un espacio preinstalado y seguro para gestionar tarjetas de fidelización digitales, entradas de eventos, ofertas, tarjetas regalo, tarjetas de embarque y credenciales de membresía.

Esta guía completa de 2026 desglosa la arquitectura de la API de Google Wallet, las credenciales de emisor, la relación entre Class y Object, los enlaces de guardado firmados con JWT y las actualizaciones push en tiempo real en Android.


1. Arquitectura de Google Wallet: Classes frente a Objects

A diferencia del paquete único .pkpass de Apple Wallet, Google Wallet separa los datos del pase en una Class (clase) y un Object (objeto):

  • Pass Class: Define las propiedades maestras de diseño, los activos de marca, el logotipo, el color principal, el nombre del emisor y las condiciones generales del programa compartidas por todos los usuarios.
  • Pass Object: Define el estado específico de cada usuario, el nombre del cliente, el número de serie o código de barras individual, el saldo actual de puntos y la fecha de caducidad.
FLUJO DE ARQUITECTURA
ARQUITECTURA INTERACTIVA
FLUJO DE ARQUITECTURA
ETAPA 01 Clase de Google Wallet (Plantilla maestra)
ETAPA 02A Objeto de usuario A (Jane Doe • 1.250 puntos)
ETAPA 02B Objeto de usuario B (John Smith • 500 puntos)
ETAPA 02C Objeto de usuario C (Alex Morgan • Nivel Gold)

2. Configuración en Google Pay & Wallet Console

Para emitir pases de Google Wallet de forma nativa:

  1. 1
    Cuenta de emisor (Issuer Account): Solicita una cuenta de emisor en Google Pay & Wallet Console.
  2. 2
    Credenciales de cuenta de servicio: Crea una Service Account en Google Cloud, concédele permisos de Google Wallet API Developer y descarga el archivo JSON con la clave privada RSA.
  3. 3
    Definición de la clase: Publica una Pass Class (por ejemplo, issuerId.loyalty_class_2026) a través de la API REST de Google Wallet.

[!NOTE]

Opción de lanzamiento inmediato: Passinstance es un emisor aprobado y verificado previamente de Google Wallet. Puedes lanzar pases de Google Wallet de inmediato sin esperar semanas a la verificación comercial de Google.


3. Generación de enlaces «Añadir a Google Wallet» firmados con JWT

Los pases de Google Wallet se distribuyen mediante JSON Web Tokens (JWT) firmados criptográficamente e integrados en URL HTTPS estándar:

TS
import jwt from "jsonwebtoken";

const claims = {
  iss: serviceAccount.client_email,
  aud: "google",
  typ: "savetowallet",
  iat: Math.floor(Date.now() / 1000),
  payload: {
    loyaltyObjects: [
      {
        id: "338810294.user_pass_jane_2048",
        classId: "338810294.loyalty_class_v1",
        state: "ACTIVE",
        accountName: "Jane Doe",
        accountId: "MEM-2048",
        barcode: {
          type: "QR_CODE",
          value: "PASS-LOYALTY-8842",
        },
      },
    ],
  },
};

const token = jwt.sign(claims, serviceAccount.private_key, { algorithm: "RS256" });
const saveUrl = `https://pay.google.com/gp/v/save/${token}`;

Cuando un cliente en Android pulsa este enlace o escanea un código QR, Google Wallet verifica la firma del JWT y añade el pase directamente a su dispositivo.


Inspector de campos — Vincula variables compartidas como {storedValue} con anulaciones opcionales para Android
Inspector de campos — Vincula variables compartidas como {storedValue} con anulaciones opcionales para Android

4. Actualizaciones inalámbricas (OTA) mediante la API REST de Google Wallet

Cuando un cliente acumula puntos o canjea una recompensa, puedes actualizar el pase en dispositivos Android enviando una solicitud PATCH a la API REST de Google Wallet:

HTTP
PATCH /walletobjects/v1/loyaltyObject/338810294.user_pass_jane_2048 HTTP/1.1
Host: walletobjects.googleapis.com
Authorization: Bearer <OAuth2_Token>
Content-Type: application/json

{
  "loyaltyPoints": {
    "label": "Points",
    "balance": {
      "int": 1500
    }
  }
}

El backend de Google actualiza el dispositivo Android en tiempo real y muestra una notificación nativa en la bandeja de alertas.


5. Emisión automatizada de Google Wallet con Passinstance

Passinstance unifica Apple Wallet y Google Wallet detrás de una única llamada a la API y un único editor visual:

TS
import { Passinstance } from "@passinstance/sdk";

const client = new Passinstance({ apiKey: process.env.PASSINSTANCE_API_KEY });

// Publish pass to both Apple Wallet and Google Wallet from one template
const pass = await client.passes.create({
  templateId: "tpl_retail_rewards",
  data: {
    customerName: "Jane Doe",
    points: 1500,
  },
});

console.log("Add to Google Wallet Link:", pass.googleWalletUrl);
Vista previa dual en vivo — Cambia entre los diseños de Apple Wallet y Google Wallet
Vista previa dual en vivo — Cambia entre los diseños de Apple Wallet y Google Wallet

Puntos clave

  • Sin necesidad de app de Android: Los clientes pulsan un enlace web o escanean un código QR para añadir sus pases a Google Wallet.
  • Plantilla unificada: Mantén un único diseño que se compila limpiamente tanto para Android como para iOS.
  • Actualizaciones inalámbricas al instante: Envía cambios de puntos y avisos directamente a la pantalla de bloqueo de Android.
Demo interactiva en vivo
Apple Wallet y Google Wallet

Pruebe un pase real de Wallet en su teléfono

Compruebe cómo funcionan los pases digitales. Escanee con la cámara de su teléfono o pulse abajo para añadirlo directamente a Apple Wallet o Google Wallet.

Artisan RoastersCafé & F&B
Test QR code for Artisan Roasters

Escanear con la cámara del móvil

Relacionado en este tema

API para desarrolladores e integraciones

Abrir centro de temas

¿Listo para lanzar su programa de tarjetas de billetera?

Cree su cuenta, diseñe su plantilla de tarjeta y pruebe tarjetas reales directamente en Apple Wallet y Google Wallet.