La Billetera de Google ofrece una API de REST que te permite crear y administrar pases enviando solicitudes a la API de la Billetera de Google a través de HTTP. Esto es útil para quienes desean compilar servicios del servidor para trabajar con pases de manera programática.
Si quieres usar la API de REST de la Billetera de Google, debes habilitarla en la consola de Google Cloud, crear una cuenta de servicio de Google Cloud y, luego, generar una clave para la cuenta de servicio.
Cuando creas pases con la API de REST, la clave de la cuenta de servicio que se usa para firmar tus objetos de pases codificados en token web JSON.
Para otras operaciones, como actualizar o borrar pases, se envía la clave de la cuenta de servicio con la solicitud para autenticarte como la entidad emisora del pase.
1. Habilita la API de REST de la Billetera de Google
Para habilitar la API de REST de la Billetera de Google, haz lo siguiente:
- Si aún no tienes una cuenta de Google Cloud, ve a la consola de Google Cloud y sigue los pasos a fin de registrarte para obtener una cuenta nueva.
- En el menú desplegable de proyectos en la parte superior de la consola, selecciona el proyecto de Google Cloud que deseas usar o crea uno nuevo.
- Ve a la página de detalles del producto de la API de la Billetera de Google en Marketplace de la consola de Google Cloud.
- Haz clic en el botón "Habilitar". En unos instantes, la API de REST de la Billetera de Google estará disponible para el proyecto de Google Cloud seleccionado.
2. Genera una clave de cuenta de servicio de Google Cloud
Para autenticar solicitudes a la API de REST de la Billetera de Google, deberás crear una cuenta de servicio y generar una clave de cuenta de servicio de la siguiente manera:
- Ve a la página “Crear cuenta de servicio” en la consola de Google Cloud.
- Completa los detalles de la cuenta de servicio. Toma nota de la dirección de correo electrónico de la cuenta de servicio que aparece debajo del campo “ID de la cuenta de servicio”. La necesitarás más adelante cuando uses la cuenta de servicio para autenticar tus solicitudes a la API de REST de la Billetera de Google.
- Haz clic en el botón "LISTO". No es necesario completar los otros pasos de creación de la cuenta de servicio.
- Haz clic en el elemento de menú "KEYS" en la parte superior de la página.
- Haz clic en el menú desplegable “AGREGAR CLAVE” y luego en “Crear clave nueva”.
- Selecciona el tipo de clave “JSON”.
- Haz clic en “CREAR” para crear y descargar la clave de la cuenta de servicio.
3. Autoriza tu cuenta de servicio en la consola de la Billetera de Google
Para autenticar tus solicitudes a la API de REST de la Billetera de Google con una clave de cuenta de servicio, debes agregar la dirección de correo electrónico de tu cuenta de servicio como un usuario a tu cuenta de entidad emisora. Para agregar tu cuenta de servicio como usuario, haz lo siguiente:
- Ve a la página “Cuentas de servicio” en la consola de Google Cloud.
- Copia la dirección de correo electrónico de la cuenta de servicio que quieres usar para autenticar tus solicitudes en la API de la Billetera de Google.
- Ve a la consola de Google Pay y la Billetera.
- En el panel de navegación izquierdo, haz clic en "Usuarios".
- Haz clic en "Invitar a un usuario".
- Ingresa la dirección de correo electrónico de tu cuenta de servicio.
- En el menú desplegable "Nivel de acceso", selecciona "Desarrollador".
- Haz clic en el botón "Invitar".
Una vez que se agrega tu cuenta de servicio, puedes usar cualquier clave de cuenta de servicio generada para autenticar solicitudes a la API de REST de la Billetera de Google. Cuando uses claves de cuentas de servicio, ten en cuenta que estas son credenciales muy sensibles que solo deben usarse en entornos seguros del servidor.