판매자 단말기 설정

이 가이드에서는 판매자용 스마트 탭을 구성하는 방법을 간략히 설명합니다.

스마트 탭을 통해 패스를 사용할 수 있도록 판매자 단말기 설정

판매자와 단말기 공급업체는 패스 개발자에게 의뢰하여 단말기를 스마트 탭 사용이 가능하도록 구성합니다. 판매자의 단말기를 스마트 탭 사용이 가능하도록 설정한 후 패스 개발자는 판매자의 단말기에서 특정 클래스를 사용할 수 있도록 설정합니다.

판매자 단말기에서 NFC를 통해 패스를 사용할 수 있는지 확인하려면 다음 단계를 완료해야 합니다.

  • 특정 판매자를 위한 패스 개발용 발급기관 계정을 결정합니다.
  • 스마트 탭 사용이 가능한 패스 사용 발급기관 계정을 결정합니다.
  • 패스 사용 발급기관의 스마트 탭용 클래스를 사용 설정합니다.

스마트 탭을 위해 설정할 값은 다음과 같습니다.

패스 사용 발급기관 계정에 대해 다음 값을 설정합니다.

  • 공개 키가 사용 발급기관 계정에 할당될 때 자동으로 생성된 회수자 ID
  • 키 버전
  • 공개 키

단말기 공급업체는 판매자 상점에 있는 단말기에 다음 값을 설정합니다.

  • 회수자 ID
  • 키 버전
  • 비공개 키

패스에 다음 값을 설정합니다.

  • 클래스를 스마트 탭으로 사용할 수 있도록 설정합니다.
  • 스마트 탭 사용이 가능한 패스 사용 발급기관 계정을 설정합니다.
  • 전달할 값 smartTapRedemptionValue를 설정합니다.

이러한 값에 대한 자세한 내용은 회수 식별자 이해하기를 참조하세요.

패스를 포함하는 발급기관 계정 결정

판매자용 패스를 포함하는 발급기관 계정을 결정해야 합니다. 이 발급기관 계정에는 각 판매자에 대해 개발하는 패스 클래스 및 객체가 포함됩니다. 다음 두 가지 옵션을 사용할 수 있습니다.

  • 모든 판매자를 위한 하나의 중앙 발급기관 계정
  • 판매자마다 하나씩 새로 부여되는 발급기관 계정

다음 예시를 참고하세요.

Foo-Loyalty에서는 iLuvCoffee와 teaLuv 모두에 대해 별도의 포인트 제도를 운영하고 있습니다. 다음 중 한 가지 방법으로 패스를 구성할 수 있습니다.

하나의 발급기관 계정 'Foo-Loyalty'에 모든 클래스를 포함합니다. 클래스 수준에서 패스를 사용할 수 있는 곳을 추적하려는 경우에 이 옵션을 사용하는 것이 좋습니다. 또한 해당 발급기관 계정에는 판매자 API에 대한 액세스 권한을 부여하지 않는 것이 좋습니다.

'Foo-Loyalty를 통한 iLuvCoffee'와 'Foo-Loyalty를 통한 teaLuv'라는 두 개의 별도 계정을 만듭니다. 이 옵션은 특정 발급기관 계정의 모든 클래스를 특정 판매자의 상점에서 사용할 수 있도록 하려는 경우나 특정 판매자에게 발급기관 계정에 대한 API 액세스 권한을 부여해야 하는 경우에 사용하는 것이 좋습니다.

여건에 가장 적합한 옵션이 무엇인지 평가하려면 회수 식별자 이해하기를 참조하세요.

다수의 판매자를 위해 패스를 개발하는 플랫폼 제공업체의 경우 새 판매자를 위한 발급기관 계정을 요청하려면 Google Pay API for Passes 지원팀에 문의하세요.

패스 사용 발급기관 계정 결정

판매자의 단말기가 패스를 읽을 수 있도록 구성되었는지 확인해야 합니다.

다음과 같은 두 가지 시나리오가 있습니다.

시나리오 1: 판매자에게 이미 사용 가능한 패스가 있는 경우

판매자가 이미 단말기를 통해 Google Pay의 패스를 사용할 수 있다고 확인한 경우에는 다음 단계를 따르세요.

  1. 판매자에게 스마트 탭 사용이 가능한 패스 사용 발급기관 계정 ID를 요청합니다. 이를 알지 못하는 판매자는 Google Pay API for Passes 지원팀에 문의하여 해당 ID를 얻도록 합니다.
  2. 판매자 단말기에서 사용 가능한 패스를 설정합니다. 자세한 내용은 패스 사용 발급기관의 스마트 탭용 클래스 사용 설정 섹션을 참조하세요.

시나리오 2: 판매자의 단말기가 스마트 탭을 지원하지만 스마트 탭 사용이 가능하도록 설정된 패스가 없는 경우

판매자가 스마트 탭을 지원하는 단말기를 사용하지만 아직 해당 기능을 활용한 적이 없는 경우에는 판매자가 단말기에 스마트 탭 기능을 설정할 수 있도록 지원해야 합니다.

판매자용 스마트 탭 사용 설정

판매자용 스마트 탭을 사용 설정하려면 다음 단계를 따르십시오.

  1. 스마트 탭 사용이 가능하도록 설정할 패스 사용 발급기관 계정을 결정합니다. 다음 두 가지 방법을 사용할 수 있습니다.
    1. 판매자를 위한 발급기관 계정을 하나 만듭니다. 새 발급기관의 계정 연락처 정보에는 판매자 정보가 포함되어야 합니다.
      1. 양식 사용: Google Pay API for Passes 액세스 권한을 신청합니다.
      2. REST API 사용: 발급기관 계정 만들기를 참조합니다.
    2. 이전에 개발된 패스를 포함하는 계정을 재사용할 수 있는지 확인합니다.
      1. 패스 개발용 발급기관 계정에 다른 판매자의 클래스가 포함되어 있으면 해당 판매자를 위한 새 계정을 설정해야 합니다. 새 계정을 설정하려면 위에서 설명한 두 가지 방법 중 하나를 사용합니다. 이 계정이 '패스 사용 발급기관 계정'이 됩니다.
      2. 패스 개발용 발급기관 계정에 특정 판매자의 클래스만 포함되어 있으면 해당 계정을 패스 사용 발급기관 계정으로 지정합니다. 새 계정을 신청할 필요가 없습니다.
  2. 단말기 공급업체에 공개 키와 키 버전을 요청합니다.
    1. 단말기 공급업체에서 먼저 회수자 ID를 요구하면 3단계로 진행하여 회수자 ID를 생성합니다.
  3. API를 사용하여 패스 사용 발급기관에 공개 키 및 키 버전을 할당합니다.
    1. 이 프로세스는 패스 사용 발급기관에 회수자 ID를 할당합니다.
    2. 회수자 ID를 확인하려면 자동 생성 회수자 ID 확인을 참조하세요.
  4. 3단계에서 설정한 회수자 ID를 단말기 공급업체에 제공합니다.
  5. 판매자에게 다음 정보를 제공합니다.
    1. 1단계에서 설정된 패스 사용 발급기관 ID와 Google Pay API for Passes 판매자 센터 계정에 대한 링크를 제공합니다.
    2. 3단계에서 설정된 회수자 ID를 제공합니다.
    3. 판매자에게 패스 사용 발급기관 계정 ID와 회수자 ID를 영구적으로 저장해야 한다고 알려줍니다. 판매자는 클래스를 스마트 탭 사용이 가능하도록 설정해야 하는 패스 개발자에게 패스 사용 발급기관 계정 ID를 제공해야 합니다.

패스 사용 발급기관 계정 ID를 갖고 있는 모든 패스 개발자가 이 판매자에 대해 스마트 탭 사용이 가능하도록 클래스를 매핑할 수 있습니다.

패스 사용 발급기관의 스마트 탭용 클래스 사용 설정

하나의 클래스를 다양한 판매자가 사용할 수 있습니다. 예를 들어 한 클래스가 나타내는 동일 포인트 제도를 서로 다른 여러 판매자 상점에서 사용할 수 있습니다. 이 경우 단일 클래스에 다양한 판매자를 나타내는 여러 개의 패스 사용 발급기관 계정 ID가 할당됩니다.

REST API를 사용하여 다양한 판매자가 클래스를 사용할 수 있도록 할 수 있습니다. API를 사용하여 스마트 탭을 구성하는 방법에 대한 자세한 내용은 패스를 스마트 탭으로 사용할 수 있도록 설정 섹션을 참조하세요.

NFC를 통해 패스에서 단말기로 전달되는 내용에 대한 자세한 내용은 패스에서 전송되는 값 섹션을 참조하세요.