Requisitos previos

Antes de comenzar a integrar la API de la Billetera de Google, completa los siguientes pasos:

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

Se requiere una cuenta de 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 una 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 pases.

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

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

A los fines de este instructivo, te familiarizarás con los conceptos y las habilidades básicas del desarrollo de aplicaciones para la plataforma de Android. Si necesitas obtener información 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

A fin de 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 en la clave del 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

El almacén de claves de depuración suele encontrarse 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 Google Pay y la Consola de la Billetera

Copia la huella digital SHA1, que se destaca en el ejemplo anterior. Se necesitan la huella digital y el nombre del paquete de la app para autorizarla. Para ello, completa los siguientes pasos:

  1. Navega a Google Pay y la Consola de 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 Agregar una aplicación.
  6. Ingresa el nombre de tu 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, se autoriza el paquete de tu aplicación y puedes verlo en la sección Permisos de la app.

5. Configura los Servicios de Google Play

Si aún no tienes Android Studio, descarga y, luego, 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 configurarlos.

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

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

6. Crea una clase de pases

Para poder crear y agregar una oferta, primero debes crear un OfferClass. Para ello, accede a Google Pay y la Consola de la Billetera, navega a la página de la API de la Billetera de Google y crea un OfferClass nuevo.

  1. Asegúrate de estar en la pestaña Administrar
  2. Si es la primera vez que creas un pase, deberías ver el mensaje “Estás en modo de demostración”.
  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 Crear una clase.
  5. Elige Oferta.
  6. Completa todos los campos obligatorios marcados con *
  7. Haz clic en Crear clase.

Repite los pasos anteriores si necesitas varias ofertas.

Ahora que creaste correctamente un OfferClass, puedes proceder a agregar pases a la Billetera de Google.