登機證 mDoc 架構

Google 錢包支援符合 ISO/IEC 18013-5 標準的登機證行動文件 (mDoc)。儲存在 Google 錢包中的符合資格登機證,可佈建為 mDoc 憑證 (mso_mdoc),並與使用者的數位身分證件一起出示給依賴方和驗證方 (例如機場安全檢查站)。

登機證 mDoc 會自動從 Google 錢包中的基礎登機證 (FlightClass 和 FlightObject) 衍生。

結構定義 ID

屬性 值
文件類型 (docType) com.google.wallet.boardingpass.1
命名空間 com.google.wallet.boardingpass.1
憑證格式 mso_mdoc (ISO/IEC 18013-5)

資料元素

登機證 mDoc 中的所有資料元素都位於 com.google.wallet.boardingpass.1 命名空間下。

元素 ID CBOR 類型 必填 說明 Passes API 來源 範例
id tstr 是 使用者將登機證儲存至 Google 錢包後,Google 產生的專屬 ID。兩位使用者儲存相同的登機證物件,會有不同的 ID。 由 Google 錢包在使用者儲存時產生 "1313e7d5d3a74b5795ffb6c3ad655778"
passenger_name tstr 是 乘客全名 (與登機證上顯示的姓名相同)。 flightObject.passengerName "Jane Doe"
passenger_name_record tstr 是 航空公司預訂確認碼 (PNR)。 flightObject.reservationInfo.confirmationCode "OWDGV9"
flight_number tstr 是 IATA 航空公司代碼和航班編號,兩者以空格分隔。 flightClass.flightHeader.carrier.carrierIataCode + " " + flightClass.flightHeader.flightNumber "UA 1585"
scheduled_departure_time tdate (#6.0(tstr)) 是 預定出發時間戳記,格式須符合 RFC 3339。 flightClass.localScheduledDepartureDateTime "2025-03-01T11:21:00-07:00"
departure_airport_iata tstr 是 出發機場的 3 字母 IATA 機場代碼。 flightClass.origin.airportIataCode "SFO"
arrival_airport_iata tstr 是 抵達機場的 3 字母 IATA 機場代碼。 flightClass.destination.airportIataCode "PVR"
assurance_level tstr 是 登機證的來源和驗證層級。請參閱「保障等級」。 由 Google 錢包根據票證擷取來源決定 "ISSUER_VERIFIED"

保障等級

Google 錢包支援多種管道的登機證 (例如 Google Wallet API、Gmail 匯入、螢幕截圖或相片),因此 assurance_level 元素會向依賴方指出登機證的來源:

值 說明
ISSUER_VERIFIED 登機證是由通過驗證的航空公司或發卡機構,直接透過 Google Wallet API 核發。
SELF_ATTESTED 登機證並非由航空公司發卡機構直接提供 (例如,根據使用者提供的螢幕截圖建立,或從 Gmail 匯入)。
SELF_ATTESTED_VERIFIED 登機證是從使用者提供的構件 (例如螢幕截圖) 匯入,Google 已透過加密編譯方式,驗證條碼中嵌入的核發機構數位簽章。