Google Pay API for Passes

Google Pay API for Passes 플랫폼을 사용하면 기업에서 수백만 명의 Android 사용자에게 포인트 카드, 기프트 카드, 쿠폰, 이벤트 티켓, 항공 탑승권, 대중교통 이용권을 선보일 수 있습니다.

이 API를 사용하면 사용자가 포인트 카드, 기프트 카드, 쿠폰, 이벤트 티켓, 항공 탑승권, 대중교통 이용권을 Google Pay 앱에 저장할 수 있는 링크나 버튼을 만들 수 있습니다. 이렇게 저장한 항목은 객체로 저장됩니다.

위치 기반 알림, 업데이트, 메시지 전송을 사용하여 이 API를 통해 고객의 패스 사용을 유도할 수 있으며 Google Pay 앱에서 이 기능을 모두 편리하게 관리할 수 있습니다.

일반적인 통합 프로세스

다음 차트는 Google Pay API for Passes와 통합하기 위한 일반적인 프로세스를 보여줍니다.

1단계: 기술적 탐색
2단계: 기술적 통합 3단계: 검증 및 품질보증 4단계: 출시 단계
5단계: 출시됨

통합의 세부 단계를 성공적으로 완료하는 데 필요한 활동은 다음과 같습니다.

기술적 탐색
1. 개발자 문서 검토
2. 서비스 계정 만들기
3. 통합 설계
기술적 통합
1. 통합 개발
2. 결과물 스테이징
검증 및 품질보증
1. 품질보증 테스트 수행
2. UX 디자인 검토(탑승권 및 이벤트 티켓만 해당)
출시 단계
1. 다른 지역에서 출시 시작
2. 크라우드 테스팅 시작
출시됨
1. 모든 지역에서 서비스 개시

권장 통합 전략

다음 표에서는 Google Pay API for Passes에서 지원하는 패스 카테고리를 보여줍니다. 표를 참고하여 패스 및 통합 유형에 따라 권장되는 통합 전략을 선택하세요.

	포인트 제도	쿠폰	기프트 카드	이벤트 티켓(ET)	항공 탑승권(BP)	대중교통 이용권(TP)	그룹화된 티켓(BP, ET, TP 전용)
웹브라우저	자바스크립트(JS) 웹 버튼	JS 웹 버튼	JS 웹 버튼	JS 웹 버튼	JS 웹 버튼	JS 웹 버튼	JS 웹 버튼
SMS 또는 이메일	JSON 웹 토큰(JWT) 링크	JWT 링크	JWT 링크	'스키니' JWT 링크	'스키니' JWT 링크	'스키니' JWT 링크	'스키니' JWT 링크
네이티브 앱	JWT 링크	JWT 링크	JWT 링크	'스키니' JWT 링크 JWT POST 요청 메서드	'스키니' JWT 링크 JWT POST 요청 메서드	'스키니' JWT 링크 JWT POST 요청 메서드	'스키니' JWT 링크 JWT POST 요청 메서드
WebView	JWT 링크	JWT 링크	JWT 링크	JWT 링크	'스키니' JWT 링크	'스키니' JWT 링크	'스키니' JWT 링크

주의: 가능하다면 WebView를 패스 통합과 함께 사용하는 대신 사용자에게 네이티브 앱에서 패스를 저장하라는 메시지를 표시하세요. WebView를 사용하는 경우 pay.google.com으로 리디렉션을 허용하는 shouldOverrideUrlLoading 메서드를 구현합니다. 이 구현은 다음 코드 스니펫과 비슷합니다.

@Override
      public boolean shouldOverrideUrlLoading(WebView view, WebResourceRequest request) {
        if(request.getUrl().getHost().startsWith("pay.google.com")) {
          Intent intent = new Intent(Intent.ACTION_VIEW, request.getUrl());
          view.getContext().startActivity(intent);
          return true;
        }
        ...
        ...
      }

통합 전략에 사용 가능한 항목을 알아보려면 패스 및 Google Pay에 대한 다음 정보를 살펴보세요.

Google Pay에 저장

모든 패스는 자바스크립트 웹 버튼, 이메일이나 SMS, Android 애플리케이션에서 JWT 링크 및 인텐트를 통해 Google Pay에 저장하는 기능을 지원합니다. 그 밖에도 다음 표와 같이 Android 앱에서 기본 SDK를 사용하여 저장 기능을 지원하는 방식에 차이가 있습니다.

	포인트 제도	쿠폰	기프트 카드	이벤트 티켓	항공 탑승권	대중교통 이용권
Android 앱에서 기본 SDK를 사용하여 저장

자세한 내용은 Google Pay에 패스를 저장하는 방법에 대한 구현 세부정보를 참조하세요.

Google Pay에서 사용

모든 패스는 NFC 탭 사용뿐 아니라 표시 및 스캔 사용을 지원합니다. Google Pay에서 패스를 사용하는 방법에 대한 구현 세부정보를 참조하세요.

Google Pay를 통해 소통

모든 패스는 비즈니스 정보 섹션, 맞춤 메시지, 맞춤 텍스트, 이미지 섹션, 사용 상태를 지원합니다. 사용 상태에 따라 사용자가 패스와 현지화를 삭제했는지 여부를 확인할 수 있습니다. 다음 표에서는 여러 패스 유형에서 고유하게 지원되는 기능과 알림을 보여줍니다.

	포인트 제도	쿠폰	기프트 카드	이벤트 티켓	항공 탑승권	대중교통 이용권
기능
템플릿
연결 쿠폰
어시스턴트의 쿼리
알림
지오펜싱 알림
만료 알림
필드 업데이트 알림 선택
임박한 이벤트, 항공편 또는 여정 알림

자세한 내용은 Google Pay를 통해 사용자와 소통하는 방법에 대한 구현 세부정보를 참조하세요.

각 기능이 Google Pay 앱에 어떻게 표시되는지 확인하려면 포인트, 기프트 카드, 쿠폰, 이벤트 티켓, 탑승권, 대중교통 이용권의 패스 템플릿 페이지를 참조하세요.