הגדרת רכיב ה-handler של התשלומים ב-Google Pay

ההפניה הזו מבוססת על סכימת אובייקט ההגדרה של ה-handler של התשלומים ב-Google Pay עבור Universal Commerce Protocol‏ (UCP).

{
  "api_version": 2,
  "api_version_minor": 0,
  "environment": "TEST" | "PRODUCTION",
  "merchant_info": {
    "merchant_id": string,
    "merchant_name": string,
    "merchant_origin": string,
    "auth_jwt": string
  },
  "allowed_payment_methods": [
    {
      "type": "CARD",
      "parameters": {
        "allowed_auth_methods": [
          "PAN_ONLY"
        ],
        "allowed_card_networks": [
          "AMEX" | "DISCOVER" | "ELECTRON" | "ELO" | "ELO_DEBIT" | "INTERAC" | "JCB" | "MAESTRO" | "MASTERCARD" | "VISA"
        ],
        "allow_prepaid_cards": boolean,
        "allow_credit_cards": boolean,
        "assurance_details_required": boolean,
        "billing_address_required": boolean,
        "billing_address_parameters": {
          "format": "MIN" | "FULL" | "FULL-ISO3166",
          "phone_number_required": boolean
        }
      },
      "tokenization_specification": {
        "type": "PAYMENT_GATEWAY" | "DIRECT",
        "parameters": {
          ...
        }
      }
    }
  ]
}

מאפיינים

נכס סוג הכרח תיאור
api_version מספר שלם חובה הגרסה הראשית של Google Pay API. יש תמיכה רק ב-2.
api_version_minor מספר שלם חובה גרסת המשנה של Google Pay API. יש תמיכה רק ב-0.
environment מחרוזת חובה סביבת Google Pay שבה רוצים להשתמש.
  • ‫TEST: פרטי תשלום לשימוש בבדיקות בלבד.
  • ‫PRODUCTION: פרטי תשלום אמיתיים שאפשר לאשר.
merchant_info אובייקט חובה פרטי הזהות של המוכר.
merchant_info.merchant_id מחרוזת חובה מזהה הסוחר שלכם ב-Google Pay מהמסוף של Google Pay ו-Wallet. השדה הזה נדרש בסביבה PRODUCTION. השדה הזה אופציונלי והמערכת מתעלמת ממנו בסביבת TEST.
merchant_info.merchant_name מחרוזת אופציונלי שם העסק שמוצג ללקוחות.
merchant_info.merchant_origin מחרוזת אופציונלי דומיין האינטרנט המוגדר במלואו שבו מתבצעת ההמרה (פורמט: hostname).
merchant_info.auth_jwt מחרוזת אופציונלי אסימון JWT להרשאה בהקשרים מסוימים של שילוב.
allowed_payment_methods object[ ] חובה אמצעי התשלום שמותרים לשימוש בעסקה הזו.
allowed_payment_methods[].type מחרוזת חובה סוג אמצעי התשלום הנתמך. יש תמיכה רק ב-CARD.
allowed_payment_methods[].parameters אובייקט חובה פרמטרים שנדרשים להגדרת אמצעי התשלום CARD.
allowed_payment_methods[].parameters.allowed_auth_methods מחרוזת[ ] חובה שדות שנתמכים באימות של עסקאות בכרטיס.
  • ‫PAN_ONLY: מחזירה את מספר החשבון הראשי (PAN) ואת תאריך התפוגה של כרטיס שרשום ב-Google Wallet.
allowed_payment_methods[].parameters.allowed_card_networks מחרוזת[ ] חובה רשתות הכרטיסים שהמוכר תומך בהן. ערכים נתמכים: AMEX, ‏ DISCOVER, ‏ ELECTRON, ‏ ELO, ‏ ELO_DEBIT, ‏ INTERAC, ‏ JCB, ‏ MAESTRO, ‏ MASTERCARD, ‏ VISA.
allowed_payment_methods[].parameters.allow_prepaid_cards בוליאני אופציונלי מגדירים את הערך false אם אתם לא תומכים בכרטיסים נטענים. ערך ברירת המחדל הוא true.
allowed_payment_methods[].parameters.allow_credit_cards בוליאני אופציונלי מגדירים את הערך false אם אתם לא תומכים בכרטיסי אשראי. ערך ברירת המחדל הוא true.
allowed_payment_methods[].parameters.assurance_details_required בוליאני אופציונלי מגדירים את הערך true כדי לבקש פרטים על אבטחת הכרטיס.
allowed_payment_methods[].parameters.billing_address_required בוליאני אופציונלי הערך שמוגדר הוא true אם נדרשת כתובת לחיוב כדי להשלים את העסקה.
allowed_payment_methods[].parameters.billing_address_parameters אובייקט אופציונלי פרמטרים שמגדירים את כתובת החיוב שמוחזרת.
allowed_payment_methods[].parameters.billing_address_parameters.format מחרוזת אופציונלי פורמט הכתובת לחיוב שנדרש להשלמת העסקה.
  • ‫MIN: שם, קידומת מדינה ומיקוד (ברירת מחדל).
  • ‫FULL: שם, כתובת רחוב, יישוב, אזור, קוד מדינה ומיקוד.
  • ‫FULL-ISO3166: שם, רחוב, יישוב, אזור, קוד מדינה, מיקוד וiso3166AdministrativeArea.
allowed_payment_methods[].parameters.billing_address_parameters.phone_number_required בוליאני אופציונלי מגדירים את הערך true אם נדרש מספר טלפון כדי להשלים את העסקה.
allowed_payment_methods[].tokenization_specification אובייקט חובה הגדרה שמגדירה איך פרטי התשלום מוחזרים אליכם.
allowed_payment_methods[].tokenization_specification.type מחרוזת חובה סוג הטוקניזציה.
  • ‫PAYMENT_GATEWAY: משמש לעיבוד תשלומים דרך [שער נתמך](/pay/api#participating-processors). מחזיר מטען ייעודי מוצפן שמועבר לספק שירותי התשלום.
  • ‫DIRECT: משמש אם אתם מפענחים את פרטי הכניסה בעצמכם (נדרשת תאימות לרמה 1 של PCI DSS).
allowed_payment_methods[].tokenization_specification.parameters אובייקט חובה פרמטרים שספציפיים לטוקניזציה שנבחרה type.

בפרמטר PAYMENT_GATEWAY, הפרמטרים הנדרשים הם: בפרמטר DIRECT, הפרמטרים הנדרשים הם: