Una vez que hayas creado un pase y lo codifiques en un JWT firmado, estarás listo para emitirlo en cualquier lugar que admita el vínculo “Agregar a la Billetera de Google”. Para ello, se le mostrará al usuario un hipervínculo o el botón “Agregar a la Billetera de Google”, que guardará el pase en su Billetera de Google una vez que lo presione. Algunos ejemplos de los casos en los que puedes usar este método incluyen sitios web, correo electrónico, SMS y muchos más.
Requisitos previos
Antes de intentar emitir un pase, asegúrate de hacer lo siguiente:
- Completa todos los pasos de la Guía de integración.
- Crea al menos una clase Passes.
- Crea al menos un objeto Passes.
- Codifica tu clase Passes y el objeto Passes en un JWT.
- Firma tu JWT con la clave de tu cuenta de servicio de Google Cloud.
1. Crea un vínculo “Agregar a la Billetera de Google”
Cuando se emite un pase con un vínculo a la “Billetera de Google”, se agrega el Objeto Passes a la Billetera de Google de un usuario y solo se puede iniciar en el contexto de una identidad de Google a la que se haya accedido.
El vínculo “Agregar a la Billetera de Google” es una URL generada de forma dinámica que contiene un token web JSON (JWT) codificado y firmado.
El vínculo Agregar a la Billetera de Google tiene el siguiente formato:
https://pay.google.com/gp/v/save/<signed_jwt>
Por ejemplo, el vínculo "Agregar a la Billetera de Google" completo se verá de la siguiente manera:
https://pay.google.com/gp/v/save/eyJhbGci6IkpXVCJ9.eyJhdWQiO...6EkC1Ahp6A
Este vínculo se puede incorporar en sitios web, correo electrónico, chat, SMS o cualquier otro lugar que admita hipervínculos.
Para obtener más información sobre cómo crear clases Passes y objetos Passes, consulta Cómo crear clases Passes y objetos Passes.
Para obtener más información sobre cómo crear el JWT firmado que se necesita para crear un vínculo "Agregar a la Billetera de Google", consulta Cómo trabajar con tokens web JSON.
2. Usa el botón “Agregar a la Billetera de Google” (recomendado).
Para cualquier plataforma que admita imágenes de hipervínculos, como sitios web y correos electrónicos, se recomienda presentar el vínculo “Agregar a la Billetera de Google” a los usuarios con un botón “Agregar a la Billetera de Google”. Para los usuarios de la Billetera de Google, el botón es un mensaje familiar que se puede reconocer como una forma de comenzar a agregar un pase a su Billetera de Google.
Los recursos de imagen están disponibles para descargar en una variedad de idiomas y orientaciones para admitir la integración de la API de la Billetera de Google.