דף זה תורגם על ידי Cloud Translation API.

הגדרת החשבון של המנפיק

דרישות מוקדמות

לפני שתמשיכו, הקפידו לבצע את השלבים הבאים:

דרישות מוקדמות

בחירת החשבון שבו יופעל התכונה 'הקשה חכמה'

לפני שממשיכים, צריך לזהות איזה חשבון יסווג בתור החשבון של מנפיק המימוש. יש שתי דרכים לבדוק זאת:

יצירת חשבון מנפיק חדש

הפרטים ליצירת קשר של החשבון החדש צריכים לכלול את הפרטים של המוכר. במאמר העזרה הזה מוסבר איך לעשות זאת במסוף Google Pay ו-Wallet: דוגמת הקוד הבאה ממחישה איך ליצור חשבון של מנפיק באמצעות 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());
}

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

בשלב הראשון, רק לחשבון המשתמש (חשבון שירות או משתמש) שיצר את חשבון המנפיק תהיה גישה אליו. צריך לעדכן את ההרשאות בחשבון המנפיק, כך שיכללו את כל המשתמשים או חשבונות השירות הנוספים שיוכלו לנהל את הכרטיסים. דוגמת הקוד הבאה ממחישה את עדכון ההרשאות בחשבון של המנפיק.

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

שימוש בחשבון קיים

כדי לבדוק אם אפשר להשתמש בחשבון מנפיק שיש בו מחלקות קיימות, יש להשתמש בקריטריונים הבאים.

אם החשבון של המנפיק לפיתוח כרטיסים כולל סיווגים למוכרים אחרים, עליכם להגדיר חשבון חדש בשם המוכר.
אם חשבון המנפיק לפיתוח כרטיסים מכיל רק מחלקות של המוֹכר הספציפי, אפשר להשתמש בו.

אם החשבון עומד בקריטריונים האלה, עליכם לעדכן את הפרטים ליצירת קשר בפרופיל העסק בפרטי המוכר כדי לוודא ששם החשבון מזהה את המוכר. רק לך תהיה גישה ל-API בחשבון הזה. מפתחים נוספים של כרטיסים צריכים ליצור לעצמם חשבונות מנפיקים.

הגדרת חשבון של מנפיק החשבון

לשימוש במסוף Google Pay ו-Wallet

בחשבון של מנפיק המימוש, צריך לבצע את השלבים הבאים:

עוברים לקטע Google Wallet API (ממשק ה-API של Google Wallet).
בוחרים באפשרות תכונות נוספות.
בוחרים באפשרות הוספת מפתח אימות.
יש להעלות מפתח ציבורי (קובץ .pem) ולציין גרסת מפתח
בוחרים באפשרות יצירת מפתח אימות.

מזהה אספן יסופק לכם אחרי שתעלו את מפתח האימות.

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

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

התשובה תכלול את הגוף ששלחת ושדה נוסף: smartTapMerchantData.smartTapMerchantId. זהו מספר הגבייה של החשבון של מנפיק המימוש.

קבלת מזהה מוֹכר

אחרי שמוסיפים מפתחות וגרסאות של מפתחות, אפשר להשתמש ב-Google Wallet API כדי לקבל את מזהה אספן על ידי שליחת בקשת GET לנקודת הקצה של המנפיקים.

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

התשובה תכלול את השדה smartTapMerchantData.smartTapMerchantId. זהו מספר הגבייה של החשבון של מנפיק המימוש.

ניהול חשבון המנפיק

ארגון הכרטיס

יש שתי גישות נפוצות לניהול מחלקות ואובייקטים של כרטיסים עבור מספר מוכרים:

חשבון מרכזי אחד של מנפיק לכל המוכרים
חשבון מנפיק אחד חדש לכל מוכר

לדוגמה, Foo-Loyalty מנהל מועדון לקוחות נפרד לשני מוכרים: ILuvCoffee ו-TeaLuv. תוכלו לנהל את הכיתות שלהם באחת מהדרכים הבאות:

גישה	תיאור
חשבון של מנפיק יחיד	להכיל את כל סיווגי הנאמנות בחשבון מנפיק אחד – "Foo-Loyalty". האפשרות הזו מומלצת אם אתם מתכננים לעקוב אחרי המקומות שבהם אפשר לממש את הכרטיסים ברמת הכיתה. זו גם אפשרות טובה אם אף פעם לא מעניקים ל-API של המוכרים גישה לחשבון המנפיק הזה.
חשבונות מנפיקים נפרדים	יוצרים שני חשבונות נפרדים של מנפיק: "iLuvCoffee דרך Foo-Loyalty" ו-"teaLuv via Foo-Loyalty". האפשרות הזו מומלצת אם רוצים לצאת מנקודת הנחה שכל המחלקות בחשבון מסוים של המנפיק ניתנות למימוש ברמת המוכר, או אם אתם מתכננים לתת ל-Merchant API גישה לחשבון של המנפיק.

גישה

תיאור

חשבון של מנפיק יחיד

להכיל את כל סיווגי הנאמנות בחשבון מנפיק אחד – "Foo-Loyalty". האפשרות הזו מומלצת אם אתם מתכננים לעקוב אחרי המקומות שבהם אפשר לממש את הכרטיסים ברמת הכיתה. זו גם אפשרות טובה אם אף פעם לא מעניקים ל-API של המוכרים גישה לחשבון המנפיק הזה.

חשבונות מנפיקים נפרדים

יוצרים שני חשבונות נפרדים של מנפיק: "iLuvCoffee דרך Foo-Loyalty" ו-"teaLuv via Foo-Loyalty". האפשרות הזו מומלצת אם רוצים לצאת מנקודת הנחה שכל המחלקות בחשבון מסוים של המנפיק ניתנות למימוש ברמת המוכר, או אם אתם מתכננים לתת ל-Merchant API גישה לחשבון של המנפיק.

חשבון המנפיק של הפדיון

יש שני תרחישים שכדאי לשקול כשקובעים את החשבון הנכון של מנפיק המימוש.

תרחיש 1: המוכר כבר משתמש בתכונה 'הקשה חכמה'

אם המוכר מאשר שהוא כבר יכול לממש מ-Google Wallet באמצעות הטרמינלים שלו (המוכר כבר מוגדר כמנפיק מימוש), בצעו את השלבים הבאים:

בקשת מזהה המנפיק של המנפיק למימוש מימוש
מוסיפים את מזהה המנפיק של המנפיק של המוכר לנכס redemptionIssuers של מחלקת הכרטיס

תרחיש 2: המוכר משתמש חדש בתכונה 'הקשה חכמה'

בתרחיש הזה, למוכר יש מסופים שתומכים ב'הקשה חכמה', אבל הוא לא השתמש בתכונה הזו. המוֹכר, ספק הטרמינל או מפתח הכרטיסים יצטרכו לבצע הגדרה חד-פעמית כדי להפעיל את התכונה 'הקשה חכמה' במסופים של המוכר.

למידע נוסף קראו את המאמר הגדרות אישיות למוכרים.