Requisitos previos

Antes de comenzar la integración con la API de la Billetera de Google, completa los siguientes pasos:

1. Regístrate para obtener una cuenta de emisor de la API de la Billetera de Google

Se necesita una cuenta de la entidad emisora para crear y distribuir pases para la Billetera de Google. Regístrate en Google Pay y la Consola de la Billetera para obtener tu cuenta de la entidad emisora. Después de registrarte, navega a la página de la API de la Billetera de Google y haz clic en Crea tu primer pase. Una vez que aceptes las Condiciones del Servicio, podrás comenzar a crear una clase de pase.

Después del paso anterior, también puedes probar el Codelab.

2. Familiarízate con el desarrollo de aplicaciones en la plataforma de Android

A los fines de este instructivo, familiarízate con los conceptos básicos y las habilidades del desarrollo de aplicaciones para la plataforma de Android. Si necesitas aprender sobre el desarrollo de Android antes de comenzar, revisa algunas lecciones de la Capacitación para desarrolladores de Android.

3. Obtén credenciales para autorizar tu app

Para usar correctamente la API de la Billetera de Google para Android en tu app para Android, debes autorizarla. Para ello, usa la huella digital SHA1 de la clave de desarrollador y el nombre del paquete.

Para obtener la aprobación de tu aplicación, debes obtener la huella digital SHA1 del certificado. Para encontrar la huella digital, abre una ventana de terminal y ejecuta la utilidad Keytool: 

keytool -alias androiddebugkey -keystore path_to_debug_or_production_keystore -list -v

Por lo general, el almacén de claves de depuración se encuentra en ~/.android/debug.keystore y su contraseña es android.

Keytool imprime la huella digital en la caparazón. Por ejemplo: 

$ keytool -alias androiddebugkey -keystore ~/.android/debug.keystore -list -v
Enter keystore password: Type "android" if using debug.keystore
Alias name: androiddebugkey
Creation date: Aug 27, 2012
Entry type: PrivateKeyEntry
Certificate chain length: 1
Certificate[1]:
Owner: CN=Android Debug, O=Android, C=US
Issuer: CN=Android Debug, O=Android, C=US
Serial number: 503bd581
Valid from: Mon Aug 27 13:16:01 PDT 2012 until: Wed Aug 20 13:16:01 PDT 2042
Certificate fingerprints:
   MD5:  1B:2B:2D:37:E1:CE:06:8B:A0:F0:73:05:3C:A3:63:DD
   SHA1: D8:AA:43:97:59:EE:C5:95:26:6A:07:EE:1C:37:8E:F4:F0:C8:05:C8
   SHA256: F3:6F:98:51:9A:DF:C3:15:4E:48:4B:0F:91:E3:3C:6A:A0:97:DC:0A:3F:B2:D2:E1:FE:23:57:F5:EB:AC:13:30
   Signature algorithm name: SHA1withRSA
   Version: 3

4. Autoriza tu app en la Consola de Google Pay y la Billetera de Google

Copia la huella digital SHA1, que se destacó en el ejemplo anterior. La huella digital y el nombre del paquete de la app son necesarios para autorizarla. Para ello, completa los siguientes pasos:

  1. Navega a la Consola de Google Pay y la Billetera.
  2. Selecciona API de la Billetera de Google en el menú de la izquierda.
  3. Selecciona la pestaña Funciones adicionales.
  4. Desplázate hacia abajo hasta la sección Permisos de la app.
  5. Haz clic en el botón Add an app.
  6. Ingresa el nombre del paquete y la huella digital de la clave de firma
  7. Haz clic en el botón Agregar aplicación.
Después de completar estos pasos, tu paquete de aplicación quedará autorizado y podrás verlo en la sección Permisos de la app.

5. Configura los Servicios de Google Play

Si aún no tienes Android Studio, descarga e instala Android Studio.

La Billetera de Google para Android forma parte de los Servicios de Google Play. A fin de importar bibliotecas de los Servicios de Google Play, sigue las instrucciones para configurar los Servicios de Google Play.

En particular, para importar la API de la Billetera de Google para Android, agrega lo siguiente al bloque de dependencias del archivo build.gradle en el módulo de la app: 

dependencies {
  implementation 'com.google.android.gms:play-services-pay:16.0.3'
}

6. Crear una clase Passes

Para poder crear y agregar una tarjeta de lealtad, primero debes crear un LoyaltyClass. Para ello, accede a la Consola de Google Pay y la Billetera, navega a la página de la API de la Billetera de Google y crea una LoyaltyClass nueva.

  1. Asegúrate de estar en la pestaña Administrar.
  2. Deberías ver el mensaje “Estás en modo de demostración” si es la primera vez que creas un pase.
  3. En el modo de demostración, haz clic en "Configurar cuentas de prueba" para agregar cuentas de prueba. Solo estas cuentas podrán guardar los pases mientras la cuenta de la entidad emisora esté en modo de demostración.
  4. Haz clic en Create a class (Crear una clase).
  5. Elige Lealtad
  6. Completa todos los campos obligatorios marcados con *.
  7. Haz clic en Crear clase.

Repite los pasos anteriores si necesitas varias tarjetas de lealtad.

Ahora que creaste correctamente un LoyaltyClass, puedes continuar con Agrega pases a la Billetera de Google.