API를 사용하여 스마트 탭 구성

이 페이지에서는 API를 사용하여 스마트 탭을 구성하는 방법에 대해 설명합니다.

스마트 탭용 패스 사용 발급기관 계정 만들기

패스 사용 발급기관 계정을 만들려면 다음 세 가지 작업을 수행합니다.

  1. 발급기관 계정을 만듭니다.
  2. 공개 키와 키 버전을 하나 이상 할당합니다.
  3. 자동으로 생성된 회수자 ID를 확인합니다.

발급기관 계정 만들기

API를 사용하여 발급기관 계정을 만들려면 프로그래매틱 방식으로 발급기관 계정 만들기를 참조하세요.

발급기관 계정을 수동으로 만들려면 비즈니스 콘솔로 이동합니다.

공개 키와 키 버전을 하나 이상 할당

공개 키와 키 버전은 단말기 공급업체에서 제공합니다.

공개 키와 키 버전을 할당하려면 승인된 서비스 계정 키를 사용하여 다음 엔드포인트에 대한 REST 호출을 실행합니다.

PATCH https://walletobjects.googleapis.com/walletobjects/v1/issuer/<issuerid>

REST 호출 본문에는 다음을 포함합니다.

{
  "smartTapMerchantData": {
    "authenticationKeys": [{
        "id": 1,
        "publicKeyPem": "<my_public_key>"
      },
      {
        "id": 2,
        "publicKeyPem": "..."
      }
    ]
  }
}

응답에는 호출 시 전송한 본문과 추가 필드 smartTapMerchantData.smartTapMerchantId가 포함됩니다. 이 ID는 패스 사용 발급기관 계정의 회수자 ID입니다. 판매자용 스마트 탭을 사용 설정하려면 이 회수자 ID와 기타 정보를 단말기 공급업체와 판매자에게 제공합니다.

발급기관 엔드포인트를 사용하는 방법에 대한 자세한 내용은 API 참조를 참고하세요.

자동 생성 회수자 ID 확인

다른 방법으로 회수자 ID를 확인할 수도 있습니다. 승인된 서비스 계정 키를 사용하여 다음 엔드포인트에 대해 REST 호출을 실행합니다.

GET https://walletobjects.googleapis.com/walletobjects/v1/issuer/<issuerid>

응답에는 smartTapMerchantData.smartTapMerchantId 필드가 포함됩니다. 이 ID는 패스 사용 발급기관 계정의 회수자 ID입니다. 판매자용 스마트 탭을 사용 설정하려면 이 회수자 ID와 기타 정보를 단말기 공급업체와 판매자에게 제공합니다.

발급기관 엔드포인트를 사용하는 방법에 대한 자세한 내용은 API 참조를 참고하세요.

패스를 스마트 탭으로 사용할 수 있도록 설정

스마트 탭으로 패스를 사용할 수 있도록 클래스 및 객체를 구성하려면 이 섹션의 안내를 따르세요.

아래 값과 패스 사용 발급기관 계정이 올바르게 설정된 경우 Google Pay의 패스에 근거리 무선통신(NFC) 아이콘이 표시됩니다. 스마트 탭 지원 단말기를 설정한 판매자만 NFC 아이콘으로 패스를 사용할 수 있습니다.

클래스 구성

NFC를 통해 객체를 사용할 수 있도록 클래스를 구성하려면 patch 요청을 실행하고 다음 값을 설정합니다.

  class.enableSmartTap = true
  class.redemptionIssuers[] = ["issuer_id_1",... ,"issuer_id_n"]

위의 클래스 속성을 설정하면 이 클래스 아래의 모든 객체를 NFC를 통해 사용할 수 있습니다. NFC 아이콘을 보려면 스마트 탭의 객체를 구성하고 패스 사용 발급기관을 설정해야 합니다. 패스 사용 발급기관을 확인하려면 패스 사용 발급기관 계정 확인을 참조하세요.

객체 구성

NFC를 통해 사용하도록 객체를 구성하려면 스마트 탭의 클래스를 구성한 후 패스에서 단말기로 전달되는 다음 값을 설정하세요.

  object.smartTapRedemptionValue = "string value to be conveyed over NFC"

NFC를 탭하면 이 값이 전송됩니다. 자세한 내용은 패스에서 전송되는 값을 참조하세요.