기본 요건
계속하기 전에 다음 단계를 완료해야 합니다.
스마트 탭을 사용할 계정 확인
계속하기 전에 패스 사용 발급기관 계정으로 지정할 계정을 지정해야 합니다. 다음 두 가지 방법으로 확인할 수 있습니다.
새 발급기관 계정 만들기
새 계정의 계정 연락처 정보에는 판매자의 정보가 포함되어야 합니다. Google Pay 및 월렛 콘솔에서 이 작업을 실행하는 방법은 이 지원 도움말을 참조하세요. 다음 코드 샘플은 Google Wallet API를 사용하여 발급기관 계정을 만드는 방법을 보여줍니다.
Java
/**
* Create a new Google Wallet Issuer account.
*
* @param issuerName The Issuer's name.
* @param issuerEmail The Issuer's email address.
* @throws IOException
*/
public void CreateIssuerAccount(String issuerName, String issuerEmail) throws IOException {
// New Issuer information
Issuer issuer =
new Issuer()
.setName(issuerName)
.setContactInfo(new IssuerContactInfo().setEmail(issuerEmail));
Issuer response = service.issuer().insert(issuer).execute();
System.out.println("Issuer insert response");
System.out.println(response.toPrettyString());
}
2,399필리핀
/**
* Create a new Google Wallet issuer account.
*
* @param string $issuerName The Issuer's name.
* @param string $issuerEmail The Issuer's email address.
*/
public function createIssuerAccount(string $issuerName, string $issuerEmail)
{
// New Issuer information
$issuer = new Google_Service_Walletobjects_Issuer([
'name' => $issuerName,
'contactInfo' => new Google_Service_Walletobjects_IssuerContactInfo([
'email' => $issuerEmail,
]),
]);
$response = $this->service->issuer->insert($issuer);
print "Issuer insert response\n";
print_r($response);
}
Python
def create_issuer_account(self, issuer_name: str, issuer_email: str):
"""Create a new Google Wallet Issuer account.
Args:
issuer_name (str): The Issuer's name.
issuer_email (str): The Issuer's email address.
"""
# New Issuer information
issuer = {'name': issuer_name, 'contactInfo': {'email': issuer_email}}
# Make the POST request
response = self.http_client.post(url=self.issuer_url, json=issuer)
print('Issuer insert response')
print(response.text)
C#
/// <summary>
/// Create a new Google Wallet Issuer account.
/// </summary>
/// <param name="issuerName">The Issuer's name.</param>
/// <param name="issuerEmail">The Issuer's email address.</param>
public void CreateIssuerAccount(string issuerName, string issuerEmail)
{
// New issuer information
Issuer issuer = new Issuer()
{
ContactInfo = new IssuerContactInfo()
{
Email = issuerEmail
},
Name = issuerName,
};
Stream responseStream = service.Issuer
.Insert(issuer)
.ExecuteAsStream();
StreamReader responseReader = new StreamReader(responseStream);
JObject jsonResponse = JObject.Parse(responseReader.ReadToEnd());
Console.WriteLine("Issuer insert response");
Console.WriteLine(jsonResponse.ToString());
}
Node.js
/**
* Create a new Google Wallet Issuer account.
*
* @param {string} issuerName The Issuer's name.
* @param {string} issuerEmail The Issuer's email address.
*/
async createIssuerAccount(issuerName, issuerEmail) {
// New Issuer information
let issuer = {
name: issuerName,
contactInfo: {
email: issuerEmail
}
};
let response = await this.httpClient.request({
url: this.issuerUrl,
method: 'POST',
data: issuer
});
console.log('Issuer insert response');
console.log(response);
}
처음에는 발급기관 계정을 만든 주 구성원 (서비스 계정 또는 사용자)만 액세스할 수 있습니다. 패스를 관리할 수 있어야 하는 추가 사용자 또는 서비스 계정을 포함하려면 발급기관 계정의 권한을 업데이트해야 합니다. 다음 코드 샘플은 발급기관 계정 권한을 업데이트하는 방법을 보여줍니다.
Java
/**
* Update permissions for an existing Google Wallet Issuer account.
*
* <p><strong>Warning:</strong> This operation overwrites all existing permissions!
*
* <p>Example permissions list argument below. Copy the add entry as needed for each email address
* that will need access. Supported values for role are: 'READER', 'WRITER', and 'OWNER'
*
* <pre><code>
* ArrayList<Permission> permissions = new ArrayList<Permission>();
* permissions.add(new Permission().setEmailAddress("emailAddress").setRole("OWNER"));
* </code></pre>
*
* @param issuerId The Issuer ID being used for this request.
* @param permissions The list of email addresses and roles to assign.
* @throws IOException
*/
public void UpdateIssuerAccountPermissions(String issuerId, ArrayList<Permission> permissions)
throws IOException {
Permissions response =
service
.permissions()
.update(
Long.parseLong(issuerId),
new Permissions().setIssuerId(Long.parseLong(issuerId)).setPermissions(permissions))
.execute();
System.out.println("Issuer permissions update response");
System.out.println(response.toPrettyString());
}
2,399필리핀
/**
* Update permissions for an existing Google Wallet Issuer account.
*
* **Warning:** This operation overwrites all existing permissions!
*
* Example permissions list argument below. Copy the entry as
* needed for each email address that will need access. Supported
* values for role are: 'READER', 'WRITER', and 'OWNER'
*
* $permissions = array(
* new Google_Service_Walletobjects_Permission([
* 'emailAddress' => 'email-address',
* 'role' => 'OWNER',
* ]),
* );
*
* @param string $issuerId The Issuer ID being used for this request.
* @param array $permissions The list of email addresses and roles to assign.
*/
public function updateIssuerAccountPermissions(string $issuerId, array $permissions)
{
// Make the PUT request
$response = $this->service->permissions->update(
$issuerId,
new Google_Service_Walletobjects_Permissions([
'issuerId' => $issuerId,
'permissions' => $permissions,
])
);
print "Permissions update response\n";
print_r($response);
}
Python
def update_issuer_account_permissions(self, issuer_id: str,
permissions: List):
"""Update permissions for an existing Google Wallet Issuer account.
**Warning:** This operation overwrites all existing permissions!
Example permissions list argument below. Copy the dict entry as
needed for each email address that will need access. Supported
values for role are: 'READER', 'WRITER', and 'OWNER'
permissions = [
{
'emailAddress': 'email-address',
'role': 'OWNER'
}
]
Args:
issuer_id (str): The Issuer ID being used for this request.
permissions (List): The list of email addresses and roles to assign.
"""
response = self.http_client.put(url=f'{self.permissions_url}/{issuer_id}',
json={
'issuerId': issuer_id,
'permissions': permissions
})
print('Permissions update response')
print(response.text)
C#
/// <summary>
/// Update permissions for an existing Google Wallet Issuer account.
/// <para />
/// <strong>Warning:</strong> This operation overwrites all existing permissions!
/// <para />
/// Example permissions list argument below. Copy the add entry as needed for each email
/// address that will need access.Supported values for role are: 'READER', 'WRITER', and 'OWNER'
/// <para />
/// <![CDATA[List<Permission> permissions = new List<Permission>();]]>
/// <para />
/// permissions.Add(new Permission { EmailAddress = "emailAddress", Role = "OWNER"});
/// </summary>
/// <param name="issuerId">The issuer ID being used for this request.</param>
/// <param name="permissions">The list of email addresses and roles to assign.</param>
public void UpdateIssuerAccountPermissions(string issuerId, List<Permission> permissions)
{
Stream responseStream = service.Permissions
.Update(new Permissions
{
IssuerId = long.Parse(issuerId),
PermissionsValue = permissions
},
long.Parse(issuerId))
.ExecuteAsStream();
StreamReader responseReader = new StreamReader(responseStream);
JObject jsonResponse = JObject.Parse(responseReader.ReadToEnd());
Console.WriteLine("Issuer permissions update response");
Console.WriteLine(jsonResponse.ToString());
}
Node.js
/**
* Update permissions for an existing Google Wallet Issuer account.
*
* **Warning:** This operation overwrites all existing permissions!
*
* Example permissions list argument below. Copy the dict entry as
* needed for each email address that will need access. Supported
* values for role are: 'READER', 'WRITER', and 'OWNER'
*
* let permissions = [
* {
* 'emailAddress': 'email-address',
* 'role': 'OWNER',
* },
* ];
*
* @param {string} issuerId The Issuer ID being used for this request.
* @param {Array} permissions The list of email addresses and roles to assign.
*/
async updateIssuerPermissions(issuerId, permissions) {
let response = await this.httpClient.request({
url: `${this.permissionsUrl}/${issuerId}`,
method: 'PUT',
data: {
issuerId: issuerId,
permissions: permissions
}
});
console.log('Permissions update response');
console.log(response);
}
기존 계정 사용
기존 패스 클래스가 포함된 발급기관 계정을 사용할 수 있는지 확인하려면 다음 기준을 사용해야 합니다.
- 패스 개발을 위한 발급기관 계정에 다른 판매자용 클래스가 포함되어 있으면 판매자를 대신하여 새 계정을 설정해야 합니다.
- 패스 개발용 발급기관 계정에 특정 판매자의 클래스만 포함된 경우 해당 계정을 사용할 수 있습니다.
계정이 이러한 기준을 충족하는 경우 비즈니스 프로필의 연락처 정보를 판매자 정보로 업데이트하여 계정 이름으로 판매자를 식별할 수 있도록 해야 합니다. 나만 이 계정에 대한 API 액세스 권한이 있어야 합니다. 추가 패스 개발자는 자체 발급기관 계정을 만들어야 합니다.
패스 사용 발급기관 계정 구성
Google Pay 및 월렛 콘솔 사용
패스 사용 발급기관 계정에서 다음 단계를 따라야 합니다.
- Google Wallet API 섹션으로 이동합니다.
- 추가 기능을 선택합니다.
- 인증 키 추가를 선택합니다.
- 공개 키 (
.pem파일)를 업로드하고 키 버전을 지정하세요. - 인증 키 만들기를 선택합니다.
인증 키가 성공적으로 업로드되면 수집기 ID가 제공됩니다.
-----BEGIN PUBLIC KEY-----
MFkwEwYHKoZIzj0CAQYIKoZIzj0DAQcDQgAEchyXj869zfmKhRi9xP7f2AK07kEo
4lE7ZlWTN14jh4YBTny+hRGRXcUzevV9zSSPJlPHpqqu5pEwlv1xyFvE1w==
-----END PUBLIC KEY-----
Google Wallet API 사용
공개 키 업로드
Google Wallet API를 사용하여 공개 키와 키 버전을 할당하려면 발급기관 엔드포인트에 PATCH 요청을 보내야 합니다.
PATCH https://walletobjects.googleapis.com/walletobjects/v1/issuer/{issuerId}
PATCH 요청 본문은 다음과 유사합니다.
{
"smartTapMerchantData": {
"authenticationKeys": [
{
"id": 1,
"publicKeyPem": "-----BEGIN PUBLIC KEY-----\n...\n-----END PUBLIC KEY-----"
},
{
"id": 2,
"publicKeyPem": "-----BEGIN PUBLIC KEY-----\n...\n-----END PUBLIC KEY-----"
}
]
}
}
다음 코드 샘플은 앞에서 언급한 데모 공개 키를 포함하도록 발급기관 계정을 업데이트하는 방법을 보여줍니다.
Java
/**
* Add a new public key to an Issuer account.
*
* @param issuerId The issuer ID being used for this request.
* @throws IOException
*/
public void AddSmartTapKey(Long issuerId) throws IOException {
// New smart tap key information
Issuer patchBody =
new Issuer()
.setSmartTapMerchantData(
new SmartTapMerchantData()
.setAuthenticationKeys(
Arrays.asList(
new AuthenticationKey()
.setId(1)
.setPublicKeyPem(
"-----BEGIN PUBLIC KEY-----\n"
+ "MFkwEwYHKoZIzj0CAQYIKoZIzj0DAQcDQgAEchyXj869zfmKhRi9xP7f2AK07kEo\n"
+ "4lE7ZlWTN14jh4YBTny+hRGRXcUzevV9zSSPJlPHpqqu5pEwlv1xyFvE1w==\n"
+ "-----END PUBLIC KEY-----"))));
Issuer response = service.issuer().patch(issuerId, patchBody).execute();
System.out.println("Issuer patch response");
System.out.println(response.toPrettyString());
}
2,399필리핀
/**
* Add a new public key to an Issuer account.
*
* @param string $issuerId The issuer ID being used for this request.
*/
public function addSmartTapKey(string $issuerId)
{
// New smart tap key information
$patchBody = new Google_Service_Walletobjects_Issuer([
'smartTapMerchantData' => new Google_Service_Walletobjects_SmartTapMerchantData([
'authenticationKeys' => [
new Google_Service_Walletobjects_AuthenticationKey([
'id' => 1,
'publicKeyPem' => "-----BEGIN PUBLIC KEY-----\nMFkwEwYHKoZIzj0CAQYIKoZIzj0DAQcDQgAEchyXj869zfmKhRi9xP7f2AK07kEo\n4lE7ZlWTN14jh4YBTny+hRGRXcUzevV9zSSPJlPHpqqu5pEwlv1xyFvE1w==\n-----END PUBLIC KEY-----"
])
]
])
]);
$response = $this->service->issuer->patch($issuerId, $patchBody);
print "Issuer patch response\n";
print_r($response);
}
Python
def add_smart_tap_key(self, issuer_id: str) -> str:
"""Add a new public key to an Issuer account.
Args:
issuer_id (str): The issuer ID being used for this request.
"""
# New smart tap key information
patch_body = {
'smartTapMerchantData': {
'authenticationKeys': [{
'id':
1,
'publicKeyPem':
'-----BEGIN PUBLIC KEY-----\nMFkwEwYHKoZIzj0CAQYIKoZIzj0DAQcDQgAEchyXj869zfmKhRi9xP7f2AK07kEo\n4lE7ZlWTN14jh4YBTny+hRGRXcUzevV9zSSPJlPHpqqu5pEwlv1xyFvE1w==\n-----END PUBLIC KEY-----'
}]
}
}
# Make the PATCH request
response = self.http_client.patch(url=f'{self.issuer_url}/{issuer_id}', json=patch_body)
print('Issuer patch response')
print(response.text)
return response.json()['smartTapMerchantData']['smartTapMerchantId']
C#
/// <summary>
/// Add a new public key to an Issuer account.
/// </summary>
/// <param name="issuerId">The issuer ID being used for this request.</param>
public void AddSmartTapKey(long issuerId)
{
// New smart tap key information
Issuer patchBody = new Issuer()
{
SmartTapMerchantData = new SmartTapMerchantData
{
AuthenticationKeys = new List<AuthenticationKey>
{
new AuthenticationKey
{
Id = 1,
PublicKeyPem = "-----BEGIN PUBLIC KEY-----\nMFkwEwYHKoZIzj0CAQYIKoZIzj0DAQcDQgAEchyXj869zfmKhRi9xP7f2AK07kEo\n4lE7ZlWTN14jh4YBTny+hRGRXcUzevV9zSSPJlPHpqqu5pEwlv1xyFvE1w==\n-----END PUBLIC KEY-----"
}
}
}
};
Stream responseStream = service.Issuer
.Patch(patchBody, issuerId)
.ExecuteAsStream();
StreamReader responseReader = new StreamReader(responseStream);
JObject jsonResponse = JObject.Parse(responseReader.ReadToEnd());
Console.WriteLine("Issuer patch response");
Console.WriteLine(jsonResponse.ToString());
}
Node.js
/**
* Add a new public key to an Issuer account.
*
* @param {string} issuerId The issuer ID being used for this request.
*/
async addSmartTapKey(issuerId) {
// New smart tap key information
let patchBody = {
smartTapMerchantData: {
authenticationKeys: [
{
id: 1,
publicKeyPem: '-----BEGIN PUBLIC KEY-----\nMFkwEwYHKoZIzj0CAQYIKoZIzj0DAQcDQgAEchyXj869zfmKhRi9xP7f2AK07kEo\n4lE7ZlWTN14jh4YBTny+hRGRXcUzevV9zSSPJlPHpqqu5pEwlv1xyFvE1w==\n-----END PUBLIC KEY-----'
}
]
}
};
let response = await this.httpClient.request({
url: `${this.issuerUrl}/${issuerId}`,
method: 'PATCH',
data: patchBody
});
console.log('Issuer patch response');
console.log(response);
}
응답에는 호출 시 전송한 본문과 추가 필드 smartTapMerchantData.smartTapMerchantId가 포함됩니다. 이 ID는 패스 사용 발급기관 계정의 회수자 ID입니다.
수집기 ID 가져오기
키와 키 버전을 추가한 후 Google Wallet API로 발급기관 엔드포인트에 GET 요청을 전송하여 수집기 ID를 가져올 수 있습니다.
GET https://walletobjects.googleapis.com/walletobjects/v1/issuer/{issuerId}
Java
/**
* Get the Collector ID for an Issuer account.
*
* @param issuerId The issuer ID being used for this request.
* @return The Collector ID
* @throws IOException
*/
public Long GetCollectorId(Long issuerId) throws IOException {
Issuer response = service.issuer().get(issuerId).execute();
System.out.println("Issuer patch response");
System.out.println(response.toPrettyString());
return response.getSmartTapMerchantData().getSmartTapMerchantId();
}
2,399필리핀
/**
* Get the Collector ID for an Issuer account.
*
* @param string $issuerId The issuer ID being used for this request.
* @return string The Collector ID.
*/
public function getCollectorId(string $issuerId)
{
$response = $this->service->issuer->get($issuerId);
print "Issuer get response\n";
print_r($response);
return $response['smartTapMerchantData']['smartTapMerchantId'];
}
Python
def get_collector_id(self, issuer_id: str) -> str:
"""Get the Collector ID for an Issuer account.
Args:
issuer_id (str): The issuer ID being used for this request.
"""
# Make the GET request
response = self.http_client.get(url=f'{self.issuer_url}/{issuer_id}')
print('Issuer get response')
print(response.text)
return response.json()['smartTapMerchantData']['smartTapMerchantId']
C#
/// <summary>
/// Get the Collector ID for an Issuer account.
/// </summary>
/// <param name="issuerId">The issuer ID being used for this request.</param>
/// <returns>The Collector ID</returns>
public string GetCollectorId(long issuerId)
{
Stream responseStream = service.Issuer
.Get(issuerId)
.ExecuteAsStream();
StreamReader responseReader = new StreamReader(responseStream);
JObject jsonResponse = JObject.Parse(responseReader.ReadToEnd());
Console.WriteLine("Issuer get response");
Console.WriteLine(jsonResponse.ToString());
return jsonResponse["smartTapMerchantData"]["smartTapMerchantId"].Value<string>();
}
Node.js
/**
* Get the Collector ID for an Issuer account.
*
* @param {string} issuerId The issuer ID being used for this request.
*
* @returns {string} The Collector ID
*/
async getCollectorId(issuerId) {
let response = await this.httpClient.request({
url: `${this.issuerUrl}/${issuerId}`,
method: 'GET'
});
console.log('Issuer patch response');
console.log(response);
return response.data.smartTapMerchantData.smartTapMerchantId;
}
응답에 smartTapMerchantData.smartTapMerchantId 필드가 포함됩니다.
이 ID는 패스 사용 발급기관 계정의 회수자 ID입니다.
발급기관 계정 관리
조직 통과
여러 판매자의 패스 클래스와 객체를 관리하는 일반적인 두 가지 방법이 있습니다.
- 모든 판매자를 위한 하나의 중앙 발급기관 계정
- 판매자별로 하나의 새 발급기관 계정
예를 들어 Foo-Loyalty에서는 IuvCoffee와 TeaLuv라는 두 판매자의 포인트 제도를 별도로 관리합니다. 패스 클래스는 다음 방법 중 하나로 관리할 수 있습니다.
| 접근 방법 | 설명 |
|---|---|
| 단일 발급기관 계정 | 하나의 발급기관 계정 'Foo-Loyalty'에 모든 포인트 클래스를 포함합니다. 이 옵션은 클래스 수준에서 패스를 사용할 수 있는 위치를 추적하려는 경우에 권장됩니다. 또한 판매자 API에 해당 발급기관 계정에 대한 액세스 권한을 부여하지 않는 것이 좋습니다. |
| 별도의 발급기관 계정 | 'Foo-Loyalty를 통한 iLuvCoffee'와 'Foo-Loyalty를 통한 TeaLuv'라는 별도의 발급기관 계정 두 개를 만듭니다. 특정 발급기관 계정에 있는 모든 클래스를 판매자 수준에서 사용할 수 있다고 가정하거나 판매자에게 발급기관 계정에 대한 액세스 권한을 API에 부여하려는 경우 이 옵션을 사용하는 것이 좋습니다. |
패스 사용 발급기관 계정
사용할 올바른 패스 사용 발급기관 계정을 결정할 때는 두 가지 시나리오를 고려해야 합니다.
시나리오 1: 판매자가 이미 스마트 탭을 사용 중인 경우
판매자가 이미 단말기를 통해 Google 월렛에서 사용할 수 있다고 확인한 경우 (판매자가 이미 패스 사용 발급기관으로 설정되어 있음) 다음 단계를 따르세요.
- 판매자의 패스 사용 발급기관 ID 요청
- 판매자의 패스 사용 발급기관 ID를 패스 클래스의
redemptionIssuers속성에 추가합니다.
시나리오 2: 판매자가 스마트 탭을 처음 사용하는 경우
이 시나리오에서는 판매자가 스마트 탭을 지원하지만 이 기능을 활용하지 않은 단말기를 사용합니다. 판매자, 단말기 공급업체 또는 패스 개발자가 판매자의 단말기에서 스마트 탭을 사용 설정하려면 일회성 설정을 실행해야 합니다.
자세한 내용은 판매자 구성을 참조하세요.