사용자는 Google Pay에서 포인트 카드 등록 및 로그인 기능을 통해 포인트 제도를 검색하고 자신의 계정으로 가입하거나 로그인할 수 있습니다. 사용자는 모바일 친화적인 웹사이트로 안내되며, 여기에서 필요한 절차를 완료하고 나면 자신의 카드를 Google Pay에 간편하게 저장할 수 있습니다.
이 가이드에서는 이 기능에 판매자의 포인트 제도를 사용 설정하는 데 필요한 구현 단계를 간략히 설명합니다.
개요
시작하려면 프로젝트가 이미 설정되어 있고 Google Pay API for Passes에 액세스할 수 있어야 합니다. 그렇지 않은 경우 Google Pay API for Passes의 안내를 따르세요.
포인트 제도 등록 및 로그인 기능을 구현하려면 다음 네 단계를 따라야 합니다.
- 등록/로그인 흐름을 테스트하기 위해 Google Pay에서 테스트 환경을 설정합니다.
- Google Pay 사용자 데이터를 활용하는 등록/로그인 페이지를 개발합니다.
- 등록/로그인 후에 Google Pay에 포인트 카드 푸시백 기능을 구현합니다.
- 확인 및 활성화를 요청합니다.
Google Pay에서 테스트 환경 설정
등록 및 로그인 URL, 포인트 제도 로고, 원하는 사용자 필드를 결정해야 합니다. 그런 다음 loyaltyclass
의 discoverableProgram
중첩 필드를 사용하여 적절한 값을 설정합니다.
discoverableProgram
에서 값을 설정하여 등록/로그인이 사용 설정된 포인트 제도의 초안 버전을 만듭니다. 테스터에게 표시되도록 하려면 테스터가 비즈니스 콘솔에 액세스할 수 있어야 합니다. 비즈니스 콘솔의 액세스 권한을 다른 사용자와 공유하는 방법에 관한 자세한 내용은 사용자 페이지 알아보기를 참조하세요.
개발 프로세스에서 구현 기능의 인증을 완료하려면 비즈니스 콘솔의 지원팀에 문의 위젯을 사용하여 문의하세요. 콘솔의 주제에서 패스를 선택하고 하위 주제에서 포인트 로그인/등록을 선택합니다.
Google Pay 사용자 데이터를 활용하는 등록 및 로그인 페이지 개발
사용자가 포인트 제도에 로그인하거나 등록하기로 선택하면 등록 또는 로그인 프로세스를 완료할 수 있도록 판매자의 웹사이트에 있는 맞춤형 페이지로 연결됩니다. 사용자가 등록을 선택하면 Google Pay에서는 사용자에게 본인의 사용자 데이터를 판매자와 공유하는 것을 승인하도록 요청합니다.
사용자가 이러한 작업을 완료할 수 있도록 두 페이지 중 하나 또는 모두를 제공해야 합니다.
- 사용자가 기존 계정에 로그인할 수 있는 로그인 URL
- 사용자가 새 계정을 만들 수 있는 등록 URL
로그인 및 등록 페이지는 다음 요구사항을 충족해야 합니다.
- 모바일 친화적인 사용자 환경을 제공합니다.
- 등록 과정에 사용되는 필수 필드의 수를 최소화합니다.
- 사용자가 단일 페이지 내에서 로그인 또는 등록을 완료할 수 있도록 합니다.
- 사용자 데이터가 안전하게 전송되도록 유효한 인증서와 함께
HTTPS
암호화를 사용합니다. - 로그인 및 등록 페이지의 업타임이 99.9% 이상이 되도록 합니다.
위의 요구 사항 외에도, 사용자가 양식을 작성하거나 해당 페이지에서 서비스 약관 동의 단계까지 진행하지 않고도 포인트 제도에 등록할 수 있도록 하는 것이 좋습니다.
- 제공된 사용자 데이터를 활용하면 계정을 생성한 후 즉시 포인트 카드를 푸시백할 수 있습니다.
- 이후 사용자에게 비밀번호와 선택적 계정 세부정보를 구성하기 위한 링크나 일회용 비밀번호를 이메일로 보낼 수 있습니다.
- 필요한 단계가 늘어날수록 사용자가 등록을 중단할 가능성이 높아지므로 이렇게 하면 사용자가 등록 과정을 포기할 가능성이 낮아집니다.
로그인 또는 등록 페이지를 표시할 때 Google Pay에서는 Android WebView를 생성하며 판매자가 제공한 URL에 대해 POST
요청이 실행됩니다. 사용자 데이터는 application/x-www-form-urlencoded 콘텐츠 유형과 UTF-8
인코딩을 사용하여 POST
요청에 포함된 userProfile
매개변수로 제공됩니다. userProfile
매개변수의 값은 Base64로 인코딩된 JSON 객체입니다.
사용자가 선택하는 작업과 판매자가 사용자 입력을 요청하도록 지정한 필드에 따라 다음과 같은 필드가 JSON 객체에 포함될 수 있습니다.
필드 | 등록 | 로그인 |
---|---|---|
이메일 | ✓ | ✓ |
firstName | ✓ | |
lastName | ✓ | |
addressLine [1-3] | ✓ | |
city | ✓ | |
state | ✓ | |
zipcode | ✓ | |
country | ✓ | |
phone | ✓ |
userProfile
에 포함되는 디코딩된 샘플 JSON 객체는 아래를 참조하세요.
리소스
{ "firstName": "Jane", "lastName": "Doe", "addressLine1": "1600 Amphitheatre Pkwy", "addressLine2": "Apt 123", "addressLine3": "Attn:Jane", "city": "Mountain View", "state": "CA", "zipcode": "94043", "country": "US", "email": "jane.doe@example.com", "phone": "555-555-5555" }
Google Pay에 포인트 카드 즉시 푸시백 구현
인증(로그인) 또는 계정 생성(등록) 후에는 판매자 페이지에서 즉시 사용자의 포인트 카드를 Google Pay에 푸시백해야 합니다.
아래와 같은 구조의 링크로 리디렉션하면 포인트 카드를 Google Pay에 푸시백할 수 있습니다. 사용자의 포인트 카드를 나타내는 LoyaltyObject
의 JSON 웹 토큰(JWT)을 생성하는 데 아직 익숙하지 않다면 객체를 나타내는 JWT 생성을 참조하세요.
https://pay.google.com/gp/v/save/{jwt_generated}
URL의 안전한 길이는 2,000자(바이트)이므로 링크를 이 한도 미만으로 유지해야 합니다. JWT로 인코딩된 객체의 크기는 작아야 하며 해당 사용자에게 해당하는 데이터만 포함해야 합니다. JWT를 만들기 전에 객체 클래스에 대부분의 데이터를 보관합니다. 한도에 맞지 않는 큰 객체의 경우에는 먼저 Google Pay API for Passes에서 객체를 만든 후 객체 ID만 JWT로 보내는 것이 좋습니다.
일반적인 통신 과정
다음 이미지에는 사용자의 등록 또는 서명을 위한 통신 과정이 나와 있습니다. 판매자 서버 간의 모든 작업은 판매자가 구현해야 합니다.
![등록 로그인 흐름](https://developers-dot-devsite-v2-prod.appspot.com/static/pay/passes/images/EnrollmentSigninFlows.png?authuser=19&hl=ko)
확인 및 활성화 요청
개발 작업을 완료하고 등록/로그인 흐름을 테스트한 후 비즈니스 콘솔 지원팀에 문의 위젯을 통해 요청을 제출하세요.
구현된 기능을 전체적으로 검토하여 Google Pay 앱과 함께 올바르게 작동하는지 확인하고 나면 해당 포인트 제도의 포인트 카드 등록/로그인 기능이 모든 사용자에게 공개됩니다. 그러면 모든 사용자가 해당 포인트 제도를 보고 이 기능을 사용할 수 있습니다.
최적의 사용자 환경을 보장하기 위해 구현된 등록/로그인 기능이 기능 요구사항을 준수하는지 확인하기 위한 검사가 반복적으로 수행됩니다. 요구사항에 맞지 않으면 판매자에게 알림이 전송되며, 문제가 해결될 때까지 로그인/등록 기능이 사용 중지될 수 있습니다.
자주 묻는 질문(FAQ)
- 포인트 제도에 사용되는 이미지에 대한 요구사항이 있나요?
- 예. 이미지는
HTTPS
위치에서 호스팅되어야 하며, 그렇지 않으면 Google Pay에 표시되지 않습니다.
- 예. 이미지는
- JWT의 구현과 디버깅을 간소화하는 도구가 있나요?
- 예. www.jwt.io와 같은 플랫폼을 사용하면 개발 과정에서 토큰을 디코딩하고 디버그하여 제출할 콘텐츠를 확인할 수 있습니다. Google은 어떠한 타사 서비스와도 제휴 관계에 있지 않으며 특별히 추천하는 타사 서비스도 없습니다.
- Base64로 인코딩된 userProfile 데이터를 올바르게 처리하려면 어떻게 해야 하나요?
- 프로세스 전체에서 UTF-8 인코딩을 사용하고 있는지 확인하세요. JSON 문자열은 먼저 UTF-8로 인코딩된 후 NO_WRAP 및 URL_SAFE 옵션을 사용하여 android.util.Base64로 인코딩됩니다. 이 방식은 RFC 3548 4조에 부합합니다.
샘플 등록 과정
![포인트 등록 과정](https://developers-dot-devsite-v2-prod.appspot.com/static/pay/passes/images/loyalty-enrollment-flow.jpg?authuser=19&hl=ko)