אמצעי תשלום ב-Google Pay

ההפניה הזו מבוססת על סכימת Card Payment Instrument ‎של אובייקט אמצעי התשלום שמוחזר על ידי Google Pay payment handler עם השלמת התשלום במערך payment.instruments.

{
  "id": string,
  "handler_id": string,
  "type": string,
  "selected": boolean,
  "display": {
    "brand": string,
    "last_digits": string,
    "description": string,
    "card_art": string
  },
  "billing_address": {
    "first_name": string,
    "last_name": string,
    "street_address": string,
    "extended_address": string,
    "address_locality": string,
    "address_region": string,
    "postal_code": string,
    "address_country": string,
    "phone_number": string
  },
  "credential": {
    "type": "PAYMENT_GATEWAY" | "DIRECT",
    "token": string
  }
}

מאפיינים

נכס	סוג	מוצג תמיד?	תיאור
id	מחרוזת	כן	מזהה ייחודי של מופע אמצעי התשלום הזה, שהוקצה על ידי הפלטפורמה.
handler_id	מחרוזת	כן	המזהה הייחודי של מופע ה-handler שיצר את הכלי הזה. הערך תואם לשדה id בהגדרות של אמצעי התשלום.
type	מחרוזת	כן	סוג אמצעי התשלום, לדוגמה card.
selected	בוליאני	לא	מציין אם המכשיר הזה נבחר על ידי המשתמש.
display	אובייקט	כן	הצגת מידע על אמצעי התשלום.
display.brand	מחרוזת	כן	המותג או הרשת של הכרטיס (לדוגמה, VISA).
display.last_digits	מחרוזת	כן	‫4 הספרות האחרונות של מספר הכרטיס.
display.description	מחרוזת	לא	תיאור של הכרטיס שמוצג למשתמש.
display.card_art	מחרוזת	לא	‫URI לתמונה שמייצגת את הכרטיס.
billing_address	אובייקט	לא	הכתובת לחיוב שמשויכת לכרטיס. מוחזר רק אם billing_address_required הוגדר ל-true בהגדרה.
billing_address.first_name	מחרוזת	לא	השם הפרטי של איש הקשר שמשויך לכתובת.
billing_address.last_name	מחרוזת	לא	שם המשפחה של איש הקשר שמשויך לכתובת.
billing_address.street_address	מחרוזת	לא	כתובת הרחוב.
billing_address.extended_address	מחרוזת	לא	תוסף לכתובת (לדוגמה, מספר דירה או סוויטה).
billing_address.address_locality	מחרוזת	לא	המקום (לדוגמה, עיר).
billing_address.address_region	מחרוזת	לא	האזור (למשל מדינה או מחוז).
billing_address.postal_code	מחרוזת	לא	המיקוד.
billing_address.address_country	מחרוזת	לא	קוד המדינה (פורמט ISO 3166-1 alpha-2 בן 2 אותיות).
billing_address.phone_number	מחרוזת	לא	מספר הטלפון. מוחזר רק אם phone_number_required הוגדר ל-true בהגדרה.
credential	אובייקט	לא	נתוני הטוקניזציה המאובטחים שמוחזרים על ידי Google Pay.
credential.type	מחרוזת	כן	סוג הטוקניזציה. התאמה לסוג שהוגדר. ‫PAYMENT_GATEWAY: משמש אם אתם מעבדים תשלומים דרך שער נתמך. ‫DIRECT: משמש אם אתם מפענחים את פרטי הכניסה בעצמכם.
credential.token	מחרוזת	כן	טוקן פרטי התשלום המוצפנים כמחרוזת שעברה סריאליזציה ב-JSON. ‫ במקרה של PAYMENT_GATEWAY, הוא מכיל את מטען הנתונים המוצפן שמועבר לשער. במקרה של DIRECT, הערך הזה מכיל את פרטי הכרטיס המוצפנים (נדרש פענוח באמצעות המפתח הפרטי). פרטים על הפורמט ותהליך הפענוח מופיעים במדריך קריפטוגרפיה של נתוני תשלום.