La función de inscripción de tarjetas de regalo (acceso) permite a los usuarios buscar un tarjeta de regalo y agregarla a la Billetera de Google. Se redireccionará a los usuarios a tu sitio web optimizado para dispositivos móviles para que completen la después del cual pueden agregar su tarjeta a la Billetera de Google.
En esta guía, se proporciona una descripción general de los pasos de implementación necesarios para habilitar tu programa de tarjetas de regalo para esta función.
Descripción general
Para comenzar, asegúrate de haber configurado tu proyecto anteriormente y de tener acceso a API de la Billetera de Google
Debes seguir estos cuatro pasos para implementar la función de acceso para el programa de tarjetas de regalo:
- Configura una clase de prueba en la Billetera de Google para probar el flujo de acceso.
- Desarrollar páginas de acceso que usen la Billetera de Google
SharedDataType - Implementa el rechazo de la tarjeta de regalo en la Billetera de Google después de acceder.
- Solicitar verificación y activación
Configura una clase de prueba en la Billetera de Google
Determina la URL de acceso, el logotipo de tu programa. Luego,
usa los campos anidados discoverableProgram en la
giftcardclass para establecer
valores adecuados.
Establece los valores en discoverableProgram para crear una versión en borrador de tu
programa de tarjetas de regalo con acceso habilitado. Para asegurarte de que los verificadores puedan ver esta información, verifica lo siguiente:
los verificadores tendrán acceso a la Consola de Google Pay y la Billetera de Google. Para obtener detalles sobre cómo compartir tu
el acceso de Google Pay y la Consola de la Billetera de Google con otras personas, consulta
Obtén información sobre la página Usuarios.
Para completar la verificación de la funcionalidad de la implementación durante el desarrollo comunícate con nosotros a través del widget de asistencia que se encuentra en la Consola de Google Pay y la Billetera de Google. Mientras estás en la consola, selecciona API de la Billetera de Google en el tema y selecciona Acceso con tarjeta de regalo en del subtema.
Desarrollar una página de acceso que usa datos del usuario de la Billetera de Google
Cuando un usuario elige agregar tu tarjeta de regalo, se los dirigirá a una página personalizada en tu sitio web para completar el proceso de acceso.
Debes proporcionar una URL de acceso con la que los usuarios puedan acceder a una cuenta existente.
Tu página de acceso debe cumplir con los siguientes requisitos:
- Brinda una experiencia del usuario optimizada para dispositivos móviles.
- Permite que el usuario complete el acceso en una sola página.
- Usa la encriptación de
HTTPScon un certificado válido para garantizar que los datos del usuario se transmitirse de forma segura. - Asegúrate de que tu página de acceso tenga un tiempo de actividad del 99.9% como mínimo.
Al presentar la página de acceso, Google Wallet creará
se realiza una WebView de Android y se realiza una solicitud POST a la
URL. Los datos del usuario se proporcionan en el parámetro SharedDataType.
que se incluye en la solicitud POST mediante
el
application/x-www-form-urlencoded y
Codificación UTF-8 El valor de SharedDataType
es un objeto JSON codificado en Base64.
Implementa el rechazo inmediato de la tarjeta de regalo en la Billetera de Google
Una vez que se autentique (acceder), tu página debe rechazar de inmediato la tarjeta de regalo del usuario en la Billetera de Google.
Puedes rechazar la tarjeta de regalo a la Billetera de Google si redireccionas a una que sigue la estructura
https://pay.google.com/gp/v/save/{jwt_generated}
La longitud segura de una URL es de 2,000 caracteres. Los vínculos deben permanezcan por debajo de este límite. Los objetos codificados en JWT deben ser pequeños y contener solo datos que son específicos del usuario. Intenta conservar la mayoría de los datos en la clase del objeto. crearlo antes de crear el JWT. Para objetos más grandes que no se ajusten al límite, considera crear primero el objeto en la API de Google Wallet y enviar solo el ID de objeto en JWT.
Flujo de comunicación típico
El flujo de comunicación para un usuario que completa el acceso se ilustra en la siguiente imagen. Todas las acciones entre "Tu servidor" y es tu responsabilidad implementarlas.
Solicitar verificación y activación
Después de que completes el trabajo de desarrollo y pruebes tu flujo de acceso, envía una solicitud. mediante la Comunícate con el equipo de asistencia de Google Pay y la Billetera de la Billetera widget.
Después de una revisión completa de tu implementación para confirmar que la función es correcta en en combinación con la app de la Billetera de Google, la función de acceso con tarjeta de regalo será lanzado públicamente para el programa de tarjetas de regalo. Esto permitirá que cualquier usuario vea el programa y aprovechar esta función.
Para garantizar una experiencia del usuario óptima, se deben realizar verificaciones recurrentes de tu acceso. implementación se realizará para garantizar el cumplimiento permanente de los requisitos de las funciones. Recibirás una notificación en caso de discrepancias y la función de acceso pueden inhabilitarse hasta que se resuelva el problema.
Preguntas frecuentes
- ¿Hay algún requisito para las imágenes que se usan en mi programa de tarjetas de regalo?
- Sí, sus imágenes deben alojarse en
HTTPSubicación ya que, de lo contrario, no aparecerán en la Billetera de Google.
- Sí, sus imágenes deben alojarse en
- ¿Existe alguna herramienta que simplifique la implementación y depuración de los JWT?
- Sí, plataformas como www.jwt.io te permiten decodificar y depurar los tokens durante el proceso de desarrollo, lo que te permite verificar el el contenido que envías. Ten en cuenta que Google no tiene afiliación ni recomendar específicamente cualquiera de dichos terceros.
- ¿Cómo se manejan correctamente los datos de SharedDataType 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 se corresponde con Sección 4 de RFC 3548.