이 페이지는 Cloud Translation API를 통해 번역되었습니다.

사용자 기프트 카드 등록

기프트 카드 등록(로그인) 기능을 사용하면 사용자가 기프트 카드를 검색하여 Google 월렛에 추가할 수 있습니다. 사용자는 모바일 친화적인 웹사이트로 안내되며, 여기에서 필요한 절차를 완료하고 나면 자신의 카드를 Google 월렛에 추가할 수 있습니다.

이 가이드에서는 이 기능에 기프트 카드 프로그램을 사용 설정하는 데 필요한 구현 단계를 간략히 설명합니다.

개요

시작하려면 프로젝트가 이미 설정되어 있고 Google Wallet API에 액세스할 수 있어야 합니다.

로그인 기능을 구현하려면 다음 네 단계를 따라야 합니다. 다음 안내를 따르세요.

로그인 흐름을 테스트하기 위해 Google 월렛에서 테스트 클래스를 설정합니다.
Google 월렛 SharedDataType을 사용하는 로그인 페이지를 개발합니다.
로그인 후 Google 월렛으로 기프트 카드 푸시백을 구현합니다.
확인 및 활성화를 요청합니다.

Google 월렛에서 테스트 수업 설정

로그인 URL, 포인트 제도 로고를 결정합니다. 그런 다음 다음의 discoverableProgram 중첩 필드를 사용합니다. giftcardclass를 사용하여 적절한 값입니다.

discoverableProgram에서 값을 설정하여 기프트 카드 프로그램을 사용 설정해야 합니다. 테스터에게 표시되도록 하려면 다음을 확인하세요. 테스터가 Google Pay 및 월렛 콘솔에 액세스할 수 있습니다. Google Pay 및 지갑 콘솔의 액세스 권한을 다른 사용자와 공유하는 방법에 관한 자세한 내용은 사용자 페이지 알아보기를 참고하세요.

개발 프로세스에서 구현 기능의 인증을 완료하려면 Google Pay 및 월렛 콘솔의 지원팀에 문의 위젯을 사용하여 문의하세요. 에 있는 동안 콘솔에서 주제에서 Google Wallet API를 선택하고 다음에서 기프트 카드 로그인을 선택합니다. 하위 주제가 될 수 있습니다.

Google 월렛 사용자 데이터를 사용하는 로그인 페이지 개발

사용자가 선물 카드를 추가하기로 선택하면 로그인 프로세스를 완료할 수 있도록 판매자의 웹사이트에 있는 맞춤형 페이지로 연결됩니다.

사용자가 기존 계정에 로그인할 수 있는 로그인 URL을 제공해야 합니다.

로그인 페이지는 다음 요구사항을 충족해야 합니다.

모바일 친화적인 사용자 환경을 제공합니다.
사용자가 단일 페이지 내에서 로그인을 완료할 수 있도록 합니다.
사용자 데이터가 안전하게 전송되도록 유효한 인증서와 함께 HTTPS 암호화를 사용합니다.
로그인 페이지의 가동시간이 99.9% 이상인지 확인합니다.

로그인 페이지를 표시할 때 Google 월렛에서 다음을 만듭니다. Android WebView 및 POST 요청이 제공된 URL입니다. 사용자 데이터는 SharedDataType 매개변수에 제공됩니다. 이는 POST 요청에 포함됩니다. <ph type="x-smartling-placeholder"></ph> application/x-www-form-urlencoded 콘텐츠 유형 및 UTF-8 인코딩 SharedDataType의 값 Base64로 인코딩된 JSON 객체입니다.

Google 월렛에 기프트 카드를 즉시 푸시백하는 기능 구현

인증(로그인) 후에는 판매자 페이지에서 즉시 사용자의 기프트 카드를 Google 월렛에 푸시백해야 합니다.

아래와 같은 구조의 링크로 리디렉션하면 기프트 카드를 Google 월렛에 푸시백할 수 있습니다.

https://pay.google.com/gp/v/save/{jwt_generated}

URL의 안전한 길이는 2,000자(영문 기준)입니다. 링크를 이 한도 미만으로 유지해야 합니다. JWT로 인코딩된 객체의 크기는 작아야 하며 사용자별 데이터만 포함해야 합니다. JWT를 만들기 전에 객체 클래스에 대부분의 데이터를 보관합니다. 한도에 맞지 않는 큰 객체의 경우 먼저 Google Wallet API에서 객체를 만든 후 객체 ID만 JWT로 보내는 것이 좋습니다.

일반적인 통신 흐름

로그인을 완료하는 사용자의 커뮤니케이션 흐름은 확인할 수 있습니다 '내 서버' 간의 모든 작업 구현할 책임은 귀하에게 있습니다

로그인 흐름

확인 및 활성화 요청

개발 작업을 완료하고 로그인 흐름을 테스트한 후 요청을 제출합니다. 를 통해 Google Pay 및 월렛 콘솔 지원팀에 문의 위젯에 추가합니다.

구현된 기능을 전체적으로 검토하여 Google 월렛 앱과 함께 올바르게 작동하는지 확인하고 나면 해당 기프트 카드 제도의 기프트 카드 로그인 기능이 모든 사용자에게 공개됩니다. 그러면 모든 사용자가 이 기능을 활용합니다.

최적의 사용자 환경을 제공하기 위해 로그인을 반복적으로 확인합니다. 기능 요구사항을 지속적으로 준수하기 위해 구현이 실행됩니다. 요구사항에 맞지 않으면 판매자에게 알림이 전송되며, 문제가 해결될 때까지 로그인 기능이 사용 중지될 수 있습니다.

자주 묻는 질문(FAQ)

기프트 카드 프로그램에 사용되는 이미지에 대한 요구사항이 있나요?
- 예. 이미지는 HTTPS 위치에서 호스팅되어야 하며, 그렇지 않으면 Google 월렛에 표시되지 않습니다.
JWT의 구현과 디버깅을 간소화하는 도구가 있나요?
- 예. www.jwt.io를 사용하면 개발 과정에서 토큰을 디버그할 수 있으므로 확인하시기 바랍니다. Google은 제휴 관계가 없으며 특별히 권장하는 바는 없습니다.
Base64로 인코딩된 SharedDataType 데이터를 올바르게 처리하려면 어떻게 해야 하나요?
- 프로세스 전반에 걸쳐 UTF-8 인코딩을 사용하고 있는지 확인합니다. JSON 문자열 먼저 UTF-8로 인코딩한 후 <ph type="x-smartling-placeholder"></ph> android.util.Base64로, NO_WRAP 및 URL_SAFE 옵션을 사용할 수 있습니다. 이는 RFC 3548 섹션 4.