탑승권 자동 추가

배경

이 기능을 사용하면 항공사에서 탑승권을 사용자의 Google 월렛으로 자동 푸시할 수 있습니다. 특히 여행 빈도가 높은 승객은 더 간단하고 마찰이 적은 방법으로 월렛에 탑승권을 추가할 수 있어 유용합니다.

이 작업은 체크인 채널 (예: 웹, 앱 또는 공항 키오스크)과 관계없이 자동으로 진행됩니다. 항공사 파트너는 사용자의 포인트 멤버십 계정 번호를 사용하여 패스를 연결하고 Wallet에 푸시할 수 있습니다.

Flow

이 기능의 작동 방식

1단계: 자주 이용하는 여행자가 월렛에 상용 고객 멤버십 패스를 추가할 수 있도록 지원합니다.

2단계: 월렛의 포인트 카드에 연결하여 상용 고객의 새 탑승권을 자동으로 추가합니다.

권장사항

  • 상용 고객의 원활한 포인트 등록을 지원하려면 Google 계정으로 가입 / 로그인 흐름을 사용 설정하는 것이 좋습니다. 그러면 사용자가 탑승권을 비롯한 Google 월렛의 다양한 진입점에서 항공사의 포인트 멤버십 등록 흐름을 확인할 수 있습니다. Google 계정으로 가입 / 로그인
  • Android 앱과 웹사이트에서 기존 포인트 멤버십 회원의 원클릭 등록을 사용 설정하는 것이 좋습니다.

참고: 이 기능은 자동 연결된 티켓 기능의 구체적인 구현입니다. 여기서 기본 패스는 포인트 카드를, 연결된 패스는 탑승권을 의미합니다. 이 문서의 나머지 부분에서는 이 기능을 설명하기 위해 더 광범위한 용어인 자동 연결된 패스, 기본 패스, 연결된 패스를 사용합니다.

자동 연결된 티켓 사용 시 고려사항

  • 기본 객체와 연결된 객체는 동일한 issuerId를 사용해야 합니다.
  • 연결된 티켓이 자동으로 푸시되는 것은 보장되지 않으며 최선의 노력으로 간주됩니다. 사용자는 자동 연결된 패스 수신을 선택 해제할 수 있습니다. 사용 사례가 중요하고 사용자가 연결된 패스를 받아야 하는 경우 사용자가 패스를 추가하도록 다른 채널을 통해 소통하는 것이 좋습니다.
  • Google 월렛 AUP 업데이트에는 자동 연결된 패스 사용에 관한 안내가 포함되어 있으며 이를 준수해야 합니다.

통합 단계

기본 객체를 이미 만든 경우 1단계를 건너뛸 수 있습니다.

  1. 필수 매개변수를 사용하여 나열된 모든 패스 유형의 객체를 만듭니다. 기본 객체입니다.
  2. 나열된 패스 유형의 다른 객체를 만듭니다. 이것이 연결된 객체가 됩니다.
  3. 기본 객체를 저장하기 전이나 후에 linkedObjectIds 매개변수의 연결된 객체 ID로 기본 객체를 업데이트합니다.

기본 패스에 linkedObjectIds를 설정하는 데 필요한 최소 페이로드가 있습니다. 필수 매개변수 3개는 다음과 같습니다.

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

연결된 객체를 패스 객체에 추가하는 JSON 요청의 예

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

객체를 패스 객체에 연결한 후의 JSON 응답 예시

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

예외 처리

API를 잘못 사용하면 다음과 같은 오류가 발생할 수 있습니다.

메시지 이유
기본 객체와 연결된 객체가 동일한 발급기관 ID를 공유하지 않습니다. 연결된 객체를 다른 발급자의 객체에 연결할 수 없습니다.
기본 객체와 연결된 객체가 동일한 객체를 참조합니다. 동일한 객체를 linkedObject로 연결할 수 없습니다.
연결된 객체가 존재하지 않습니다. 연결된 객체는 이미 월렛 API에 삽입되어 있어야 합니다.
연결된 객체에 이미 다른 연결된 객체가 있습니다. 중첩된 연결 객체를 추가할 수 없습니다. 연결된 객체는 다른 연결된 객체를 가질 수 없습니다.
객체가 이미 다른 객체에 연결되어 있습니다. 중첩된 연결 객체를 추가할 수 없습니다. 기본 객체는 연결된 객체 자체일 수 없습니다.