Cómo comenzar
¿Qué es la API de la Billetera de Google?
La API de Google Wallet 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 los requisitos y la complejidad de mi empresa?
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 PROD.
Complejidad de la configuración básica
1 cuenta de la consola empresarial o 1 cuenta principal de la consola empresarial para muchas cuentas de emisor
- Esta opción permite un enfoque administrado de forma centralizada con 1 cuenta principal y de cero a muchas empresas secundarias o emisores.
- 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 para 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.
- Credenciales de cuenta de servicio de 1 a varios.
- 1 credencial por empresa o entidad emisora
- Diferentes accesos a credenciales por empresa
Complejidad de la configuración compleja
1 cuenta principal para 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 varios proyectos de Google Cloud
- Usuarios distintos de la consola empresarial por entidad emisora.
- De 1 a muchas credenciales de cuentas de servicio.
- 1 credencial de PROD por empresa o entidad emisora
- 1 credencial de DEV por empresa o entidad emisora
Comunícate con el equipo de asistencia
Trabaja con pases
¿Cómo borro clases u objetos?
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 agrupo varios pases?
Con GroupingID, es fácil agrupar pases.
¿Cómo actualizo solo una parte de un pase?
Sigue 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 enviadas a la API de la Billetera de Google?
Las llamadas a la API de la Billetera de Google están limitadas a 20 solicitudes por segundo.
¿Cuál es el tiempo de espera recomendado para las solicitudes enviadas a la API de Google Wallet?
La API de Google Wallet no tiene un ANS oficial, pero recomendamos un tiempo de espera de 10 segundos, basado en una latencia del percentil 99 de aproximadamente 5 segundos. También ten en cuenta que la latencia suele depender de factores externos, como el tiempo necesario para recuperar una imagen alojada en un servidor externo cuando se inserta un objeto con esa imagen, ya que esto depende de la latencia del servidor externo.
¿Por qué se prohíben las imágenes personales en los pases de la Billetera de Google?
La Billetera de Google no admite imágenes personales en los pases porque las reglamentaciones actuales establecen que todos los consumidores tienen derecho a rechazar la recopilación o el tratamiento de datos sensibles. Si los datos sensibles (imágenes personales) forman parte del objeto valioso (en un JWT), podría haber problemas de hosting en los que los datos se vuelvan públicos, lo que no se contempla en el 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 Google Wallet?
Para obtener una lista de los códigos de error y las excepciones que devuelve la API de Google Wallet, consulta Códigos de error.¿Cómo habilito las notificaciones push?
Por el momento, la Billetera de Google no admite las notificaciones push creadas por desarrolladores. Sin embargo, la Billetera de Google proporciona notificaciones oportunas para los siguientes pases. Por el momento, la Billetera de Google no admite las notificaciones push creadas por desarrolladores.
| Vertical | Notificación | Activada | Documentación |
|---|---|---|---|
| Evento | Próximo recordatorio | 3 horas antes del evento | Documentos |
| Tarjeta de embarque | Próximo recordatorio | 3 horas antes de la salida del vuelo | Documentos |
| Tarjeta de embarque | Actualización del pase | Cambio de terminal, puerta de embarque, hora de embarque o hora de salida de origen | 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 del inicio del “intervalo de tiempo” | Documentos |
| Genérico | Recordatorio de vencimiento | 48 horas antes de que finalice el “intervalo de tiempo” | documentos |
¿Se pueden borrar los IDs de comerciante?
Actualmente, no se pueden borrar ni archivar los IDs de comercio en la Consola de Google Pay y la Billetera.
¿Cómo uso la función de Applinking?
El vinculamiento de aplicaciones requiere la inclusión en la lista de entidades permitidas, que se puede solicitar aquí.
¿La Billetera de Google admite la delimitación geográfica?
Por el momento, no se admite la delimitación geográfica.
¿Cómo configuro un programa de lealtad?
Puedes configurar un programa de lealtad y de inscripción siguiendo esta guía.
¿Cómo le envío a Google mi logotipo para los pases de transporte público?
Usa este formulario para enviar a Google el logotipo que se incluirá en la lista de entidades permitidas.
¿Cómo controlar correctamente los datos de userProfile codificados en Base64?
Asegúrate de usar la codificación UTF-8 durante todo el proceso. Primero, la cadena JSON se codifica en UTF-8 y, luego, se codifica con android.util.Base64 con las opciones NO_WRAP y URL_SAFE. Esto se corresponde con la sección 4 del RFC 3548.
¿Cómo creo cuentas de entidad emisora de forma programática?
Consulta esta guía para crear cuentas de la entidad emisora a través de la API.
Toque inteligente
¿Necesito un lector de NFC especial para los pases de Google SmartTap?
Debe ser una terminal compatible con el toque inteligente. Puedes encontrar una lista de los proveedores certificados aquí.
¿Cómo hago para que mis pases funcionen con NFC?
Sigue esta configuración para habilitar la canjeabilidad de tu pase con Smart Tap.
Tokens web JSON (JWT)
¿Existen herramientas que simplifiquen la implementación y la depuración de los JWT?
Sí, las 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. Ten en cuenta que Google no está afiliado a ninguno de estos terceros y no recomienda específicamente a ninguno de ellos.
La URL de mi vínculo JWT supera la restricción del navegador de 1,800 caracteres. ¿Qué debo hacer?
Puedes crear previamente 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 para el evento?
La hora que se muestra en el pase es la hora local del evento, con el desfase correspondiente a la zona horaria en la que se realiza el evento.
Mi logotipo no se renderiza en los pases que creé. ¿Qué podría estar mal?
- En primer lugar, asegúrate de que tu logotipo cumpla con los lineamientos y esté guardado en formato PNG.
- Asegúrate de que el logotipo esté disponible con alta confiabilidad. No redirecciones a archivos de imágenes, ya que esto puede causar errores 404. Tus imágenes deben estar alojadas en una ubicación HTTPS, ya que, de lo contrario, no se verán en la Billetera de Google.
- Asegúrate de que todos los campos obligatorios marcados como tales 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, haz clic en el botón "Comunicarse con el equipo de asistencia" 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" que se encuentra 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 enviar comentarios sobre la documentación?
Para dejar comentarios sobre la documentación, 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 la documentación". A continuación, describe tus comentarios en el área de texto y haz clic en "Enviar".