Inscripción de tarjeta de regalo del usuario

La función de inscripción de tarjetas de regalo (acceso) permite a los usuarios buscar un tarjeta de regalo y la agregarás 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 y de tener acceso a la 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:

1. Configura una clase de prueba en la Billetera de Google para probar tu flujo de acceso.
2. Desarrolla páginas de acceso que usen SharedDataType de la Billetera de Google.
3. Implementa el envío de la tarjeta de regalo a la Billetera de Google después de acceder.
4. Solicita la verificación y activación.

Configura 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 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 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 al cliente en la consola de Google Pay y Wallet. 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.

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:

• Brinda una experiencia del usuario optimizada para dispositivos móviles.
• Permite que el usuario complete el acceso en una sola página.
• Usa el cifrado HTTPS con 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 el 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 mediante el el tipo de contenido application/x-www-form-urlencoded y Codificación UTF-8 El valor de SharedDataType es un objeto JSON codificado en Base64.

Nota: 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.

Implementa la devolución inmediata de la tarjeta de regalo a 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.

Nota: No implementes un botón de la API de la Billetera de Google. ya que los usuarios deben volver a la Billetera de Google sin interacción adicional.

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}

Nota: Asegúrate de incluir la barra final “/” en la URL antes del JWT.

Nota: Los JWT no están encriptados. Solo incluye datos en el vínculo directo que sean seguros para compartir como texto sin formato.

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 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

En la siguiente imagen, se ilustra el flujo de comunicación de un usuario que completa el acceso. Todas las acciones entre "Tu servidor" y es tu responsabilidad implementarlas.

Solicitar 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 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 esa 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 continuo de los requisitos de las funciones. 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.
• ¿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 corresponde con la sección 4 de la RFC 3548.