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.
2. Configuración en Google Pay & Wallet Console
Para emitir pases de Google Wallet de forma nativa:
-
1
Cuenta de emisor (Issuer Account): Solicita una cuenta de emisor en Google Pay & Wallet Console.
-
2
Credenciales de cuenta de servicio: Crea una Service Account en Google Cloud, concédele permisos de
Google Wallet API Developery descarga el archivo JSON con la clave privada RSA. -
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:
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.

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:
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:
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);

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.





