Agregar tarjetas de embarque automáticamente

Fondo

Esta función permite que las aerolíneas envíen automáticamente tarjetas de embarque a la Billetera de Google de un usuario. Esto beneficiará especialmente a los viajeros frecuentes, quienes disfrutarán de un método más simple y con menos fricciones para agregar sus pases de abordar a la Billetera, dada su mayor frecuencia de viajes.

Esto sucede automáticamente, independientemente del canal de check-in (p.ej., la Web, la app o el kiosco del aeropuerto). Las aerolíneas asociadas pueden usar el número de cuenta de lealtad del usuario para correlacionar y enviar el pase a su Billetera.

Cómo funciona esta función

Paso 1: Habilita al viajero frecuente para que agregue su pase de lealtad de viajero frecuente a la Billetera.

Paso 2: Agrega automáticamente los nuevos pases de abordar para el pasajero frecuente vinculándolos a su pase de lealtad en la Billetera.

Prácticas recomendadas

• Para habilitar la inscripción sin inconvenientes en el programa de lealtad para los viajeros frecuentes, considera habilitar un flujo de Acceder con Google o registrarse con Google. Luego, los usuarios podrán descubrir el flujo de inscripción en el programa de lealtad de tu aerolínea en varios puntos de entrada de la Billetera de Google, incluidas las tarjetas de embarque.
• Considera habilitar el registro con 1 clic para los miembros existentes del programa de lealtad en tu sitio web y aplicación para Android.

Nota: Esta función es una implementación específica de la capacidad de vinculación automática de pases. En este contexto, el pase principal hace referencia a una tarjeta de lealtad y el pase vinculado hace referencia a una tarjeta de embarque. En el resto de este documento, se usa la terminología más amplia (pases vinculados automáticamente, pase principal y pase vinculado) para describir esta funcionalidad.

Algunas consideraciones para usar los pases vinculados automáticamente

• El objeto principal y el objeto vinculado deben usar el mismo issuerId.
• No se garantiza el envío automático de los pases vinculados, y se considera un esfuerzo óptimo. Los usuarios pueden inhabilitar la recepción de pases vinculados automáticamente. Si el caso de uso es crítico y el usuario debe recibir el pase vinculado, te recomendamos que te comuniques a través de otro canal para asegurarte de que agregue el pase.
• Las actualizaciones de la PAU de la Billetera de Google incluyen orientación sobre el uso de los pases vinculados automáticamente, que se debe cumplir.

Pasos para la integración

Si ya creaste un objeto principal, puedes omitir el paso 1.

1. Crea un objeto de cualquier tipo de pase que se indique con los parámetros requeridos. Este es el objeto primario.
2. Crea otro objeto de cualquier tipo de pase que se indique. Este será el objeto vinculado.
3. Antes o después de guardar el objeto principal, actualiza el objeto principal con el ID del objeto vinculado en el parámetro linkedObjectIds.

Se requiere una carga útil mínima para establecer los linkedObjectIds en un pase principal. Los 3 parámetros obligatorios son los siguientes:

1. ISSUERID.PRIMARY_OBJECT_ID
2. ISSUERID.PRIMARY_CLASS_ID
3. ISSUERID.LINKED_OBJECT_ID

Ejemplo de solicitud en formato JSON para agregar un objeto vinculado a un objeto de pase

  …
  {
    "id": "ISSUERID.PASS_OBJECTID",
    "classId": "ISSUERID.PASS_CLASSID",
    "barcode": {
      "type": "qrCode",
      "value": "QR code"
    },
    "linkedObjectIds": ["ISSUERID.LINKED_PASS_OBJECTID"]
  }
  …

Ejemplo de respuesta JSON después de vincular un objeto a un objeto de pase

  …
  "state": "active",
  "linkedObjectIds": {
    "ISSUERID.LINKED_PASS_OBJECTID"
  }
  …

Manejo de excepciones

Es posible que se produzcan errores si se usa la API de forma incorrecta, lo que puede incluir lo siguiente:

Mensaje	Motivo
El objeto principal y el objeto vinculado no comparten el mismo ID de emisor.	No puedes adjuntar un objeto vinculado al objeto de otro emisor.
El objeto principal y el objeto vinculado se refieren al mismo objeto.	No puedes adjuntar el mismo objeto como linkedObject.
El objeto vinculado no existe.	El objeto vinculado ya debería estar insertado en la API de Wallet.
El objeto vinculado ya tiene otro objeto vinculado. No se pueden agregar objetos vinculados anidados.	Los objetos vinculados no pueden tener otro objeto vinculado.
El objeto ya está vinculado a otro objeto. No se pueden agregar objetos vinculados anidados.	El objeto principal no puede ser un objeto vinculado por sí solo.