אובייקטים של תגובת JSON

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

PaymentData

זהו אובייקט תגובה שמוחזר על ידי Google אחרי שהמשלם מאשר את התשלום.

PaymentDataRequest.PaymentDataRequest.PaymentDataRequest.
נכס סוג תמיד קיים תיאור
apiVersion number כן הגרסה הראשית של ה-API. הערך בתשובה זהה לערך שצוין ב-
apiVersionMinor number כן גרסה משנית של ה-API. הערך בתשובה זהה לערך שצוין ב-
paymentMethodData PaymentMethodData כן נתונים על אמצעי התשלום שנבחר.
email מחרוזת לא כתובת אימייל, אם הערך של emailRequired הוא true ב- ‫PaymentDataRequest. אם בקשה אחרת מגדירה את המאפיין לערך true, לא תהיה לכך השפעה.
shippingAddress הכתובת לא כתובת למשלוח, אם הערך של shippingAddressRequired הוא true ב-

דוגמה

בדוגמה הזו של תגובה לגרסה 2.0 של Google Pay API מוצג CARD אמצעי תשלום שנבחר בגיליון התשלום של Google Pay. נוצר טוקן של אמצעי תשלום עבור שער התשלומים example.

{
  "apiVersion": 2,
  "apiVersionMinor": 0,
  "paymentMethodData": {
    "type": "CARD",
    "description": "Visa •••• 1234",
    "info": {
      "cardNetwork": "VISA",
      "cardDetails": "1234",
      "cardFundingSource": "CREDIT"
    },
    "tokenizationData": {
      "type": "PAYMENT_GATEWAY",
      "token": "examplePaymentMethodToken"
    }
  }
}

PaymentMethodData

האובייקט הזה מספק נתונים של אמצעי תשלום שנבחר.

נכס סוג תמיד קיים תיאור
type מחרוזת כן PaymentMethod type נבחר בדף התשלום של Google Pay. ‫
description מחרוזת כן

הודעה שמוצגת למשתמש ומתארת את אמצעי התשלום שמשמש למימון העסקה הזו.
info אובייקט כן הערך של המאפיין הזה תלוי באמצעי התשלום type שמוחזר. מידע על CARD זמין במאמר CardInfo.
tokenizationData PaymentMethodTokenizationData לא נתוני טוקניזציה של אמצעי התשלום שנבחר.

דוגמה

בדוגמה הזו של תגובה אפשר לראות איך CARD אמצעי תשלום שנבחר בגיליון התשלום של Google Pay יוצר טוקן של אמצעי תשלום עבור שער example.

{
  "type": "CARD",
  "description": "Visa •••• 1234",
  "info": {
    "cardNetwork": "VISA",
    "cardDetails": "1234"
  },
  "tokenizationData": {
    "type": "PAYMENT_GATEWAY",
    "token": "examplePaymentMethodToken"
  }
}

CardInfo

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

נכס סוג תמיד קיים תיאור
cardDetails מחרוזת כן הפרטים על הכרטיס. הערך הזה הוא בדרך כלל ארבע הספרות האחרונות של מספר חשבון התשלומים שנבחר.
assuranceDetails AssuranceDetailsSpecifications כן האובייקט הזה מספק מידע על האימות שבוצע בנתוני התשלום שהוחזרו אם הערך של assuranceDetailsRequired הוא true ב- CardParameters.
cardNetwork מחרוזת כן

חברת האשראי של התשלום שנבחר. הערכים שמוחזרים תואמים לפורמט של allowedCardNetworks ב- CardParameters.

הערך של רשת הכרטיסים הזו לא צריך להיות מוצג לקונה. הוא משמש כשצריך את פרטי הכרטיס של הקונה. לדוגמה, אם צוות תמיכת הלקוחות צריך את הערך הזה כדי לזהות את הכרטיס שבו הקונה השתמש לעסקה. כדי להציג תיאור למשתמש, צריך להשתמש במאפיין description של PaymentMethodData.
billingAddress הכתובת לא הכתובת לחיוב שמשויכת לאמצעי התשלום שצוין, אם הערך של billingAddressRequired הוא true ב- CardParameters.
cardFundingSource מחרוזת כן

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

  • UNKNOWN
  • CREDIT
  • DEBIT
  • PREPAID

דוגמה

בדוגמה הזו מוצג כרטיס ברשת ויזה.

{
  "cardNetwork": "VISA",
  "cardDetails": "1234",
  "cardFundingSource": "CREDIT",
  "assuranceDetails": {
    "cardHolderAuthenticated": false,
    "accountVerified": true
  }
}

AssuranceDetailsSpecifications

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

שם סוג תיאור
accountVerified בוליאני אם הערך הוא true, המשמעות היא שבוצע אימות בעלות על פרטי הכניסה לתשלום שהוחזרו Cardholder.
cardHolderAuthenticated בוליאני

אם true, מציין שבוצעו זיהוי ואימות (ID&V) של אמצעי התשלום שהוחזר.

אם false, אפשר לבצע את אותו אימות מבוסס-סיכונים כמו בעסקאות בכרטיס. אימות מבוסס-סיכון יכול לכלול, בין היתר, אימות נוסף באמצעות פרוטוקול 3D Secure, אם רלוונטי.

אתם יכולים לקבל ולעבד את אובייקט התגובה גם אם אתם לא משתמשים בשדה assuranceDetails. כדי לקבל את האובייקט הזה, צריך לכלול את assuranceDetailsRequired: true באובייקט Request של CardParameters.

PaymentMethodTokenizationData

האובייקט הזה מספק נתוני טוקניזציה של אמצעי התשלום.

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

האסימון של אמצעי התשלום שנוצר.

דוגמה

זוהי דוגמה לתשובה עם טוקנים שהוכנה עבור שער example.

{
  "type": "PAYMENT_GATEWAY",
  "token": "examplePaymentMethodToken"
}

כתובת

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

אפשר להחזיר כתובות בפורמטים MIN,‏ FULL ו-FULL-ISO3166. בטבלה הבאה אפשר לראות את המאפיינים ששייכים לכל פורמט.

נכס פורמט הכתובת תיאור
name MIN,‏ FULL,‏ FULL-ISO3166 השם המלא של הנמען.
postalCode MIN,‏ FULL,‏ FULL-ISO3166 המיקוד.
countryCode MIN,‏ FULL,‏ FULL-ISO3166 קוד מדינה בפורמט ISO 3166-1 alpha-2.
phoneNumber MIN,‏ FULL,‏ FULL-ISO3166 מספר טלפון, אם הערך של phoneNumberRequired הוא true ב- PaymentDataRequest.
address1 FULL, FULL-ISO3166 השורה הראשונה של הכתובת.
address2 FULL, FULL-ISO3166 השורה השנייה של הכתובת.
address3 FULL, FULL-ISO3166 השורה השלישית של הכתובת.
locality FULL, FULL-ISO3166 עיר, יישוב, שכונה או פרבר.
administrativeArea FULL, FULL-ISO3166 חלוקה משנית של מדינה, כמו מדינה (State) או מחוז.
sortingCode FULL, FULL-ISO3166 קוד המיון.
iso3166AdministrativeArea FULL-ISO3166 קוד אזור מנהלי לפי תקן ISO 3166-2, שמתאים לערך של administrativeArea.

דוגמה

זו דוגמה לפורמט FULL-ISO3166 של כתובת בארצות הברית עם כמה שורות של נתוני כתובת.

{
  "name": "John Doe",
  "address1": "c/o Google LLC",
  "address2": "1600 Amphitheatre Pkwy",
  "address3": "Building 40",
  "locality": "Mountain View",
  "administrativeArea": "CA",
  "countryCode": "US",
  "postalCode": "94043",
  "sortingCode": ""
  "iso3166AdministrativeArea": "US-CA"
}