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

PaymentData

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

דוגמה

התגובה לדוגמה הזו ל-Google Pay API בגרסה 2.0 מציגה אמצעי תשלום מסוג 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

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

דוגמה

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

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

CardInfo

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

דוגמה

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

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

AssuranceDetailsSpecifications

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

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

PaymentMethodTokenizationData

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

דוגמה

זו דוגמה לתגובה עם אסימון שהוכנה לשער example.

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

PaymentAuthorizationResult

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

דוגמה

הדוגמה הבאה מראה את תוצאת התשלום שמוחזרת אחרי שהתשלום מעובד:

{
  "transactionState": "ERROR",
  "error": {
    "reason": "PAYMENT_DATA_INVALID",
    "message": "Cannot pay with payment credentials",
    "intent": "PAYMENT_AUTHORIZATION"
  }
}

PaymentDataError

דוגמה

בדוגמה הזו מוצגים הכוונה וההודעה של השגיאה שיופיעו בגיליון התשלום.

{
  "error": {
    "reason": "SHIPPING_OPTION_INVALID",
    "message": "This shipping option is invalid for the given address",
    "intent": "SHIPPING_OPTION"
  }
}

כתובת

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

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

דוגמה

זו דוגמה לכתובת בפורמט 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"
}

IntermediatePaymentData

האובייקט הזה מוחזר על ידי הקלט של Google Pay API onPaymentDataChanged() כשמשנים את הכתובת למשלוח או את אפשרויות המשלוח בגיליון התשלום.

דוגמאות

בדוגמה הזו מוצג המטען הייעודי (payload) הזמני שמוחזר מ-Google Pay API כשמשנים את הכתובת למשלוח.

{
  "callbackTrigger": "SHIPPING_ADDRESS",
  "shippingAddress": {
    "administrativeArea": "NY",
    "countryCode": "US",
    "locality": "New York",
    "postalCode": "10011"
  },
  "shippingOptionData": {
    "id": "shipping-001"
  }
}

בדוגמה הזו מוצג המטען הייעודי (payload) של הביניים שמוחזר כשאמצעי התשלום משתנה.

{
  "callbackTrigger": "PAYMENT_METHOD",
  "paymentMethodData": {
    "type": "CARD",
    "info": {
      "cardNetwork": "VISA",
      "cardFundingSource": "CREDIT",
      "billingAddress": {
        "administrativeArea": "NY",
        "countryCode": "US",
        "locality": "New York",
        "postalCode": "10011"
      }
    }
  }
}

IntermediateAddress

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

דוגמה

בדוגמה הזו מוצגת הכתובת שנבחרה בגיליון התשלום.

{
  "administrativeArea": "NY",
  "countryCode": "US",
  "locality": "New York",
  "postalCode": "10011"
  "iso3166AdministrativeArea": "US-NY"
}

SelectionOptionData

דוגמה

בדוגמה הזו מוצגת אפשרות המשלוח שנבחרה בגיליון התשלום.

{
  "id": "shipping-001"
}

IntermediatePaymentMethodData

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

IntermediateCardInfo

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