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 debido a su mayor frecuencia de viajes.

Esto sucede automáticamente, independientemente del canal de registro (p.ej., la Web, la app o el kiosco del aeropuerto). La aerolínea usa el número de cuenta de lealtad del usuario para correlacionar y enviar el pase.

Nota: Esta función es una implementación específica de la capacidad de "pases vinculados automáticamente". En el resto del documento, se usa la terminología más amplia "pases vinculados automáticamente", así como "pase principal" y "pase vinculado" para describir esta funcionalidad.

Cómo funciona esta función

Paso 1: Habilita al viajero frecuente para que agregue su pase de lealtad 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.

Algunas consideraciones para usar los pases vinculados automáticamente

• El objeto principal y el objeto vinculado deben usar el mismo issuerId.
• Hay un límite de 50 objetos vinculados por objeto principal.
• 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 principal.
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"
  }
  …

Comportamiento esperado

Después de recibir una respuesta correcta, los dispositivos con el pase que actualizaste deberían recibir el pase vinculado. Este pase vinculado se agrupará con el pase principal. Los usuarios pueden ver el pase vinculado deslizando el dedo hacia la derecha.

Manejo de excepciones

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