Pases vinculados automáticamente

Información general

La función Pases vinculados automáticamente te permite enviar pases adicionales a un usuario que ya tiene tu pase existente en su Billetera de Google. También puedes vincular previamente los pases a un pase principal cuando un usuario guarde el pase principal (principal). El pase de vinculación automática se agrupa con el pase principal con un texto destacado encima del pase principal que informa al usuario que se vinculó un pase nuevo. Se admiten los siguientes tipos de pases como pases principales o vinculados:

  • Entrada del evento
  • Tarjeta de embarque
  • Pase de transporte público
  • Oferta
  • Tarjeta de regalo
  • Pase de lealtad
  • Pase genérico

Casos de uso

Es posible que tengas casos de uso diferentes para vincular pases a uno existente. A continuación, se muestran algunos ejemplos:

  • Vincular una oferta a una tarjeta de lealtad existente
  • Vincular un cupón de comida a una tarjeta de embarque o entrada para evento
  • Vincula un pase de estacionamiento a una entrada para evento.

Algunas consideraciones para usar pases con vinculación automática

  • El objeto principal y el objeto vinculado deben usar el mismo ID de emisor.
  • Hay un límite de 50 objetos vinculados por objeto principal.
  • El envío automático de pases vinculados no está garantizado y se considera el mejor esfuerzo. Los usuarios pueden inhabilitar la opción de recibir pases con vínculos automáticos. Si el caso de uso es crítico y el usuario debe recibir el pase vinculado, te recomendamos que te comuniques mediante otro canal para asegurarte de que el usuario agregue el pase.
  • Las actualizaciones de la AUP de la Billetera de Google incluyen orientación sobre el uso de pases con vínculos automáticos que se deben 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 enumerado con los parámetros obligatorios. Este es el objeto primary.
  2. Crea otro objeto de cualquier tipo de pase de la lista. Este será el objeto linked.
  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.

Existe una carga útil mínima obligatoria para configurar los linkedObjectIds en un pase principal. Los 3 parámetros obligatorios incluyen lo siguiente:

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

Ejemplo de solicitud 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

Si usas la API de forma incorrecta, pueden ocurrir errores, como los siguientes:

Mensaje Motivo
El objeto principal y el objeto vinculado no comparten el mismo ID de la entidad emisora. 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 que 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. No se pueden agregar objetos vinculados anidados. El objeto principal no puede ser un objeto vinculado por sí solo.
No se pueden agregar más objetos vinculados; se superó el límite. Se alcanzó el límite de 50 pases vinculados para el pase principal.