Kartı veren kuruluşun hesabının yapılandırması

Ön koşullar

Devam etmeden önce aşağıdaki adımları tamamladığınızdan emin olun:

• Ön koşullar

Akıllı Dokunma için etkinleştirilecek hesabı belirleme

Devam etmeden önce, hangi hesabın Redemption Issuer hesap olarak tanımlanacağını belirlemeniz gerekir. Bunu belirlemenin iki yolu vardır:

Yeni bir Düzenleyen hesabı oluşturma

Yeni hesabın iletişim bilgilerinde satıcının bilgileri yer almalıdır. Bu işlemin Google Pay ve Cüzdan Konsolu'nda nasıl yapılacağıyla ilgili talimatlar için bu destek makalesine bakın. Aşağıdaki kod örneği, Google Cüzdan API'sini kullanarak kartı veren bir hesap oluşturmayı göstermektedir:

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());
}

PHP

/**
 * 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);
}

Başlangıçta, yalnızca Sertifikayı Veren hesabı oluşturan ana hesap (hizmet hesabı veya kullanıcı) erişime sahip olur. Kartı Veren hesabın izinlerini, kartları yönetebilmesi gereken ek kullanıcıları veya hizmet hesaplarını içerecek şekilde güncellemeniz gerekir. Aşağıdaki kod örneğinde, Sertifikayı Veren hesap izinlerinin güncellenmesi gösterilmektedir.

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());
}

PHP

/**
 * 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&lt;Permission> permissions = new List&lt;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);
}

Mevcut bir hesabı kullan

Mevcut geçiş sınıflarını içeren bir Sertifikayı Veren hesabı kullanıp kullanamayacağınızı belirlemek için aşağıdaki ölçütler kullanılmalıdır.

• Kartın geliştirilmesi için kullanılan Veren hesap diğer satıcılara yönelik sınıflar içeriyorsa satıcı adına yeni bir hesap oluşturmanız gerekir.
• Pasaport geliştirme için kart geliştirme hesabınız yalnızca ilgili satıcı için sınıfları içeriyorsa bu hesap kullanılabilir.

Hesap bu ölçütleri karşılıyorsa işletme profilindeki iletişim bilgilerini satıcının bilgileriyle güncelleyerek hesap adının satıcıyı tanımlamasını sağlamanız gerekir. Bu hesaba yalnızca sizin API erişiminiz olmalıdır. Ek kart geliştiricileri, kartı veren kuruluşun hesaplarını kendileri oluşturmalıdır.

Teklifi veren kullanıcının hesap yapılandırması

Google Pay ve Cüzdan Konsolu'nu kullanma

Teklifi Veren kullanıcının hesabında aşağıdaki adımları uygulamanız gerekir:

1. Google Cüzdan API'si bölümüne gidin
2. Ek özellikler'i seçin
3. Kimlik doğrulama anahtarı ekle'yi seçin.
4. Bir ortak anahtar (.pem dosyası) yükleyin ve bir anahtar sürümü belirtin
5. Kimlik doğrulama anahtarı oluştur'u seçin.

Kimlik doğrulama anahtarı başarıyla yüklendikten sonra toplayıcı kimliği size sağlanır.

Not: Terminal sağlayıcınız siz bir toplayıcı kimliği sağlayana kadar size ortak anahtar vermezse aşağıdaki demo anahtarını kullanarak bir ortak anahtar oluşturabilirsiniz. Terminal sağlayıcınızdan gerçek ortak anahtarı aldıktan sonra bu demo anahtarını kaldırdığınızdan emin olun.

-----BEGIN PUBLIC KEY-----
MFkwEwYHKoZIzj0CAQYIKoZIzj0DAQcDQgAEchyXj869zfmKhRi9xP7f2AK07kEo
4lE7ZlWTN14jh4YBTny+hRGRXcUzevV9zSSPJlPHpqqu5pEwlv1xyFvE1w==
-----END PUBLIC KEY-----

Google Cüzdan API'sini kullanma

Ortak anahtar yükle

Google Cüzdan API'sini kullanarak ortak anahtarlar ve anahtar sürümleri atamak için Kartı Verenler uç noktasına PATCH isteğinde bulunmanız gerekir.

PATCH https://walletobjects.googleapis.com/walletobjects/v1/issuer/{issuerId}

Önemli: smartTapMerchantData.authenticationKeys[].id özelliği, 1 ile 2,147,483,647 (dahil) arasında bir tam sayı olmalıdır. Her ortak anahtarın benzersiz bir anahtar sürümü olmalıdır.

PATCH isteğinin gövdesi aşağıdakine benzer:

{
    "smartTapMerchantData": {
        "authenticationKeys": [
            {
                "id": 1,
                "publicKeyPem": "-----BEGIN PUBLIC KEY-----\n...\n-----END PUBLIC KEY-----"
            },
            {
                "id": 2,
                "publicKeyPem": "-----BEGIN PUBLIC KEY-----\n...\n-----END PUBLIC KEY-----"
            }
        ]
    }
}

Aşağıdaki kod örneği, bir Sertifikayı Veren hesabının daha önce bahsedilen demo ortak anahtarını içerecek şekilde güncellenmesini göstermektedir:

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());
}

PHP

/**
 * 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);
}

Yanıtta, gönderdiğiniz gövde metni ve ekstra bir alan (smartTapMerchantData.smartTapMerchantId) yer alır. Bu, Teklif Veren hesabının Toplayıcı Kimliğidir.

Toplayıcı kimliğini alma

Anahtarları ve anahtar sürümlerini ekledikten sonra, Düzenleyenler uç noktasına GET isteği göndererek Toplayıcı Kimliğinizi almak için Google Cüzdan API'sini kullanabilirsiniz.

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();
}

PHP

/**
 * 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;
}

Yanıt, smartTapMerchantData.smartTapMerchantId alanını içerecektir. Bu, Teklifi Veren hesabının Toplayıcı Kimliğidir.

Kartı veren kuruluşun hesabının yönetimi

Kartın geçtiği kuruluş

Birden fazla satıcı için geçiş sınıflarını ve nesnelerini yönetmeyle ilgili iki yaygın yaklaşım vardır:

• Tüm satıcılar için tek bir merkezi veren hesap
• Her satıcı için yeni bir Sertifikayı Veren hesabı

Örneğin Foo-Loyalty, iki satıcı için ayrı bağlılık programlarını yönetiyor: ILuvCoffee ve TeaLuv. Kart sınıfları, aşağıdaki yollardan biriyle yönetilebilir:

Yaklaşım	Açıklama
Tek Veren hesap	Tüm bağlılık sınıflarını, tek bir Veren hesabı "Foo-Loyalty" altında içermelidir. Sınıf düzeyinde kartlarınızın nerelerde kullanılabileceğini takip etmeyi planlıyorsanız bu seçenek önerilir. Bu seçenek, satıcılarınıza Düzenleyen hesabına hiçbir API erişimi vermemeniz durumunda da iyi bir seçenektir.
Ayrı Veren Kuruluş hesapları	İki ayrı Veren hesap oluşturun: "Fo-Loyalty aracılığıyla iLuvCoffee" ve "Fo-Loyalty aracılığıyla teaLuv." Belirli bir Sertifikayı Veren hesabı altındaki tüm sınıfların satıcı düzeyinde kullanılabilir olduğunu varsaymak veya Issuer (Satıcı) hesabına merchants API erişimi vermeyi planlıyorsanız bu seçenek önerilir.

Teklif Veren hesap

Kullanılacak doğru Teklifi Veren hesabı belirlerken dikkate alınması gereken iki senaryo vardır.

1. Senaryo: Satıcı zaten Akıllı Ödeme özelliğini kullanıyor

Satıcı, teklifi Google Cüzdan'dan kendi terminalleriyle (satıcı zaten Teklif Veren olarak ayarlanmıştır) kullanabileceğini onaylarsa aşağıdaki adımları uygulayın:

1. Satıcının teklif veren kuruluş kimliğini isteme
2. Satıcının Tekliften Yararlanma Kimliği'ni kart sınıfınızın redemptionIssuers mülküne ekleyin

2. Senaryo: Satıcı, Akıllı Ödeme özelliğini kullanmaya yeni başladı

Bu senaryoda satıcı, Akıllı Dokunma'yı destekleyen ancak özelliği kullanmayan terminallere sahiptir. Satıcı, terminal sağlayıcı veya kart geliştiricisinin satıcı terminallerinde Akıllı Dokunma'yı etkinleştirmek için tek seferlik kurulumu yapması gerekir.

Daha fazla bilgi için Satıcı yapılandırması bölümüne bakın.