Cómo comenzar
¿Qué es la API de la Billetera de Google?
La API de la Billetera de Google permite que los desarrolladores creen pases digitales en la Billetera de Google. Actualmente, la API de la Billetera de Google admite tarjetas de embarque, entradas para eventos, tarjetas de lealtad, ofertas y pases de transporte público. Más recientemente, se agregó un tipo de pase genérico para admitir casos de uso adicionales.
¿Cómo puedo configurar mi entorno de desarrollo según mis requisitos empresariales y la complejidad?
A continuación, se incluyen guías que se pueden usar para configurar un entorno de desarrollo que se adapte a diferentes niveles de complejidad y seguridad empresarial. El uso de varias cuentas de servicio puede permitir que los desarrolladores creen un entorno de prueba independiente de su entorno de producción.
Complejidad de la configuración básica
1 cuenta de la Consola de Negocio o 1 cuenta principal de la Consola de Negocio a muchas cuentas de emisor
- Esta opción permite un enfoque administrado de forma centralizada con 1 cuenta principal y de cero a muchas empresas o entidades emisoras secundarias.
- 1 proyecto de Google Cloud
- 1 credencial de cuenta de servicio
- Es un solo conjunto de usuarios.
Complejidad de configuración promedio
1 cuenta principal a muchas cuentas de emisor
- Esta opción permite un enfoque administrado de forma centralizada con 1 cuenta principal y muchas empresas secundarias.
- 1 proyecto de Google Cloud
- Usuarios distintos de la consola empresarial por entidad emisora.
- Entre 1 y muchas credenciales de cuentas de servicio.
- 1 credencial por empresa o entidad emisora
- Acceso a credenciales diferentes por empresa
Complejidad de la configuración compleja
1 cuenta principal a muchas cuentas de emisor
- Esta opción permite un enfoque administrado de forma centralizada con 1 cuenta principal y muchas empresas secundarias.
- De 1 a muchos proyectos de Google Cloud
- Usuarios distintos de la Consola de Negocio por emisor
- De 1 a varias credenciales de cuenta de servicio
- 1 credencial de PROD por empresa o entidad emisora.
- 1 credencial de DEV por empresa o entidad emisora
Comunicarse con el servicio de asistencia
Cómo trabajar con pases
¿Cómo borro objetos o clases?
Actualmente, no puedes borrar clases ni objetos de la Billetera de Google. Sin embargo, los usuarios pueden desvincular objetos de su Billetera de Google.
¿Cómo puedo agrupar varios pases?
El uso de GroupingID facilita la agrupación de pases.
¿Cómo actualizo solo parte de un pase?
Consulta nuestra guía de rendimiento para comprender cómo realizar actualizaciones parciales con solicitudes PATCH.
¿Puedo crear pases por lotes?
Sigue nuestra guía de rendimiento para comprender cómo realizar solicitudes por lotes con la API.
Preguntas generales
¿Cuál es el límite de frecuencia para las solicitudes que se envían a la API de la Billetera de Google?
Las llamadas a la API de la Billetera de Google tienen un límite de frecuencia de 20 solicitudes por segundo.
¿Por qué se prohíbe que se muestren imágenes personales en los pases de la Billetera de Google?
La Billetera de Google no admite imágenes personales en los pases porque la normativa actual establece que todos los consumidores tienen derecho a inhabilitar la recopilación o el procesamiento de datos sensibles. Si se tienen datos sensibles (imágenes personales) como parte del objeto valioso (en un JWT), es posible que haya problemas de alojamiento en los que los datos puedan hacerse públicos, lo que está fuera del acuerdo de consentimiento original. Para garantizar la confidencialidad de los datos, no se permiten imágenes personales. Estamos trabajando para admitir imágenes personales en el futuro.
¿Qué códigos de error devuelve la API de la Billetera de Google?
Para obtener una lista de los códigos de error y las excepciones que devuelve la API de la Billetera de Google, consulta Códigos de error.¿Cómo habilito las notificaciones push?
Actualmente, la Billetera de Google no admite notificaciones push escritas por desarrolladores. Sin embargo, la Billetera de Google proporciona notificaciones oportunas para los siguientes pases. Actualmente, la Billetera de Google no admite notificaciones push escritas por desarrolladores.
| Vertical | Notificación | Activado | Documentación |
|---|---|---|---|
| Evento | Próximo recordatorio | 3 horas antes del evento | docs |
| Tarjeta de embarque | Próximo recordatorio | 3 horas antes de la salida del vuelo | docs |
| Tarjeta de embarque | Actualización del pase | Cambio de terminal de origen, puerta, hora de embarque o de salida | documentos |
| Tarjeta de oferta | Recordatorio de vencimiento | 48 horas antes de que venza la tarjeta de oferta | documentos |
| Genérico | Próximo recordatorio | 24 horas antes de que comience el “intervalo de tiempo” | documentos |
| Genérico | Recordatorio de vencimiento | 48 horas antes de que finalice el “tiempo interno” | docs |
¿Se pueden borrar los IDs de comerciante?
Actualmente, los IDs de comercios no se pueden borrar ni archivar desde la Consola de Google Pay y la Billetera de Google.
¿Cómo uso la función de vinculación de apps?
La vinculación de apps requiere una lista de entidades permitidas, que se puede solicitar aquí.
¿La Billetera de Google admite el geovallado?
El geovallado no es compatible en este momento.
¿Cómo configuro un programa de lealtad?
Para configurar un programa de inscripción y lealtad, sigue esta guía.
¿Cómo envío mi logotipo a Google para los pases de transporte público?
Usa este formulario para enviar el logotipo a Google para que lo incluya en la lista de entidades permitidas.
¿Cómo se manejan correctamente los datos de userProfile codificados en Base64?
Asegúrate de usar la codificación UTF-8 durante todo el proceso. La cadena JSON primero se codifica en UTF-8 y, luego, se codifica con android.util.Base64 con las opciones NO_WRAP y URL_SAFE. Esto corresponde a la sección 4 de la RFC 3548.
¿Cómo creo cuentas de entidad emisora de forma programática?
Consulta esta guía para crear cuentas de emisor a través de la API.
Toque inteligente
¿Necesito un lector NFC especial para los pases de Google SmartTap?
Debe ser una terminal compatible con SmartTap. Puedes encontrar una lista de proveedores certificados aquí.
¿Cómo hago para que mis pases funcionen con NFC?
Sigue esta configuración para habilitar que tu pase se pueda canjear con el Smart Tap.
Tokens web JSON (JWT)
¿Hay herramientas que simplifiquen la implementación y depuración de JWT?
Sí, plataformas como www.jwt.io te permiten decodificar y depurar tus tokens durante el proceso de desarrollo, lo que te permite verificar el contenido que envías. Tenga en cuenta que Google no tiene ninguna afiliación y no recomienda específicamente ninguno de esos terceros.
La URL de mi vínculo de JWT supera la restricción del navegador de 1,800 caracteres. ¿Qué debo hacer?
Puedes precrear clases y objetos con la API antes de crear el vínculo para guardar el pase (JWT).
Solución de problemas
¿Por qué mi configuración de hora muestra la hora incorrecta del evento?
La hora que se muestra en el pase es la hora local del evento, con un desfase para la hora en la que se encuentra.
Mi logotipo no se renderiza en los pases que creé. ¿Qué podría estar mal?
- En primer lugar, asegúrate de que tu logotipo siga los lineamientos y esté guardado en formato PNG.
- Asegúrate de que el logotipo esté disponible con alta confiabilidad. No redireccionas a archivos de imagen, ya que pueden causar errores 404. Tus imágenes deben estar alojadas en una ubicación HTTPS, ya que, de lo contrario, no se mostrarán en la Billetera de Google.
- Asegúrate de que todos los campos obligatorios marcados como obligatorios en la API estén configurados en el pase.
Asistencia y comentarios
¿Cómo puedo comunicarme con el equipo de asistencia técnica?
Si necesitas más ayuda, comunícate con el equipo de asistencia al cliente. Para ello, haz clic en el botón “Comunicarse con el equipo de asistencia” ubicado en la barra lateral izquierda de la consola de Google Pay y la Billetera.
¿Cómo puedo enviar comentarios sobre el producto?
Para dejar comentarios sobre el producto, haz clic en el botón “Enviar comentarios” en el cuadrante superior derecho de la página del sitio para desarrolladores y selecciona “Comentarios sobre el producto”. A continuación, describe tus comentarios en el área de texto y haz clic en "Enviar".
¿Cómo puedo dejar comentarios sobre la documentación?
Para enviar comentarios sobre la documentación, haz clic en el botón "Enviar comentarios" en el cuadrante superior derecho de la página del sitio del desarrollador y selecciona "Comentarios sobre la documentación". A continuación, describe tus comentarios en el área de texto y haz clic en "Enviar".