Agregar tarjetas de embarque automáticamente

Fondo

La función permite que las aerolíneas envíen automáticamente pases de abordar a la Billetera de Google de un usuario. Esto beneficiará especialmente a los viajeros frecuentes, quienes disfrutarán de un método más sencillo y con menos fricciones para agregar sus tarjetas de embarque 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 opera 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 las nuevas tarjetas de embarque para el viajero frecuente vinculándolas a su pase de lealtad en la Billetera.

Prácticas recomendadas

• Para habilitar el registro sin inconvenientes en el programa de lealtad para viajeros frecuentes, considera habilitar un flujo de registro o acceso 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 app 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 el usuario 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 otra entidad emisora.
El objeto principal y el objeto vinculado hacen referencia 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.