La función de inscripción de tarjetas de regalo (acceso) permite a los usuarios buscar una 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 el proceso, después del cual podrán 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 y de tener acceso a la API de la Billetera de Google.
Debes seguir estos cuatro pasos para implementar la función de acceso de tu programa de tarjetas de regalo:
- Configura una clase de prueba en la Billetera de Google para probar tu flujo de acceso.
- Desarrolla páginas de acceso que usen
SharedDataTypede la Billetera de Google. - Implementa el envío de la tarjeta de regalo a la Billetera de Google después de acceder.
- Solicita la verificación y activación.
Cómo configurar una clase de prueba en la Billetera de Google
Determina la URL de acceso y el logotipo de tu programa. Luego, usa los campos anidados discoverableProgram en giftcardclass para establecer los valores adecuados.
Establece los valores en discoverableProgram para crear una versión preliminar de tu programa de tarjetas de regalo habilitado para el acceso. Para asegurarte de que los verificadores puedan ver esta información, verifica que tengan acceso a Google Pay y la consola de Wallet. Para obtener detalles sobre cómo compartir el acceso a Google Pay y Wallet Console con otras personas, consulta Más información sobre la página Usuarios.
Para completar la verificación de la funcionalidad de tu implementación durante el proceso de desarrollo, comunícate con nosotros mediante el widget de asistencia de contacto en la consola de Google Pay y Wallet. En la consola, selecciona API de Google Wallet en el tema y Acceso con tarjetas de regalo en el subtema.
Desarrolla una página de acceso que use los datos del usuario de la Billetera de Google
Cuando un usuario elige agregar tu tarjeta de regalo, se lo dirige a una página personalizada en tu sitio web para completar el proceso de acceso.
Debes proporcionar una URL de acceso en la que un usuario pueda acceder a una cuenta existente.
Tu página de acceso debe cumplir con los siguientes requisitos:
- Proporciona una experiencia del usuario optimizada para dispositivos móviles.
- Permite que el usuario complete el acceso en una sola página.
- Usa el cifrado
HTTPScon un certificado válido para garantizar que los datos del usuario se transmitan de forma segura. - Asegúrate de que tu página de acceso tenga un tiempo de actividad de al menos un 99.9%.
Cuando se presente la página de acceso, la Billetera de Google creará un WebView de Android y se realizará una solicitud POST a la URL que proporcionaste. Los datos del usuario se proporcionan en el parámetro SharedDataType, que se incluye en la solicitud POST con el tipo de contenido
application/x-www-form-urlencoded y la codificación UTF-8. El valor del parámetro SharedDataType es un objeto JSON codificado en Base64.
Implementa la devolución inmediata de la tarjeta de regalo a la Billetera de Google
Una vez que se realice la autenticación (acceso), tu página debería enviar inmediatamente la tarjeta de regalo del usuario a la Billetera de Google.
Para volver a enviar la tarjeta de regalo a la Billetera de Google, redirecciona a un vínculo que siga la estructura
https://pay.google.com/gp/v/save/{jwt_generated}
La longitud segura para una URL es de 2,000 caracteres. Tus vínculos deben permanecer por debajo de este límite. Los objetos codificados en JWT deben ser pequeños y contener solo datos específicos del usuario. Intenta mantener la mayoría de los datos en la clase del objeto y créala 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 la Billetera de Google y enviar solo el ID del objeto en el JWT.
Flujo de comunicación típico
En la siguiente imagen, se ilustra el flujo de comunicación de un usuario que completa el acceso. Es tu responsabilidad implementar todas las acciones entre "Tu servidor".
Solicita la verificación y activación
Después de completar el trabajo de desarrollo y probar el flujo de acceso, envía una solicitud a través del widget de asistencia al cliente de Google Pay y Wallet Console.
Después de una revisión completa de tu implementación que confirme que la función es correcta en combinación con la app de la Billetera de Google, se lanzará públicamente la función de acceso con tarjeta de regalo para tu programa de tarjetas de regalo. Esto permitirá que cualquier usuario vea el programa y use esta función.
Para garantizar una experiencia del usuario óptima, se realizarán verificaciones recurrentes de la implementación de tu acceso para garantizar el cumplimiento continuo de los requisitos de la función. Recibirás una notificación en caso de discrepancias, y es posible que la función de acceso esté inhabilitada 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í, tus imágenes deben alojarse en la ubicación
HTTPS, ya que, de lo contrario, no se mostrarán en la Billetera de Google.
- Sí, tus imágenes deben alojarse en la ubicación
- ¿Hay alguna herramienta que simplifique la implementación y depuración de los 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. Ten en cuenta que Google no tiene ninguna afiliación y no recomienda a ninguno de esos terceros de forma específica.
- ¿Cómo manejamos 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 corresponde con la sección 4 de la RFC 3548.