ابزار پرداخت گوگل پی

این ارجاع بر اساس طرحواره ابزار پرداخت کارت برای شیء ابزار پرداخت است که توسط کنترل‌کننده پرداخت Google Pay پس از تکمیل پرداخت در آرایه 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	رشته	بله	شناسه منحصر به فرد برای نمونه کنترل‌کننده‌ای که این ابزار را تولید کرده است. مربوط به فیلد id در پیکربندی کنترل‌کننده پرداخت است.
type	رشته	بله	نوع ابزار پرداخت، مثلاً card .
selected	بولی	خیر	نشان می‌دهد که آیا این ابزار توسط کاربر انتخاب شده است یا خیر.
display	شیء	بله	نمایش اطلاعات مربوط به ابزار پرداخت.
display. brand	رشته	بله	برند/شبکه ​​کارت (برای مثال، «ویزا»).
display. last_digits	رشته	بله	چهار رقم آخر شماره کارت.
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).
billing_address. phone_number	رشته	خیر	شماره تلفن. فقط در صورتی برگردانده می‌شود که phone_number_required در پیکربندی روی true تنظیم شده باشد.
credential	شیء	خیر	داده‌های توکن‌سازی امن که توسط گوگل پی برگردانده می‌شوند.
credential. type	رشته	بله	نوع توکن‌سازی. با نوع پیکربندی‌شده مطابقت دارد. PAYMENT_GATEWAY : اگر پرداخت‌ها را از طریق یک درگاه پشتیبانی‌شده پردازش می‌کنید، استفاده می‌شود. DIRECT : در صورتی استفاده می‌شود که خودتان اعتبارنامه‌ها را رمزگشایی کنید.
credential. token	رشته	بله	توکن اعتبارنامه پرداخت رمزگذاری شده به عنوان یک رشته سریالی شده با JSON. برای PAYMENT_GATEWAY ، این شامل بار داده رمزگذاری شده برای ارسال به درگاه شما است. برای DIRECT ، این شامل جزئیات کارت رمزگذاری شده است (نیاز به رمزگشایی با استفاده از کلید خصوصی شما دارد). برای جزئیات بیشتر در مورد قالب و فرآیند رمزگشایی، به راهنمای رمزنگاری داده‌های پرداخت مراجعه کنید.