وسيلة الدفع في Google Pay

تستند هذه المَرجعية إلى مخطط Card Payment Instrument الخاص بكائن أداة الدفع الذي يعرضه معالج الدفع في 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	سلسلة	نعم	تمثّل هذه السمة العلامة التجارية للبطاقة أو الشبكة (مثل "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 المكوّن من حرفَين).
billing_address.phone_number	سلسلة	لا	رقم الهاتف يتم عرض هذا الحقل فقط إذا تم ضبط phone_number_required على true في الإعدادات.
credential	عنصر	لا	بيانات الترميز الآمن التي تعرضها Google Pay
credential.type	سلسلة	نعم	نوع الترميز تطابق النوع الذي تم ضبطه. PAYMENT_GATEWAY: يُستخدَم إذا كنت تعالج الدفعات من خلال بوابة متوافقة. DIRECT: يُستخدَم هذا النوع إذا كنت تفك تشفير بيانات الاعتماد بنفسك.
credential.token	سلسلة	نعم	رمز مميّز لبيانات اعتماد الدفع المشفّرة كسلسلة متسلسلة بتنسيق JSON بالنسبة إلى PAYMENT_GATEWAY، يحتوي هذا الحقل على الحمولة المشفّرة التي سيتم تمريرها إلى البوابة. بالنسبة إلى DIRECT، يحتوي هذا الحقل على معلومات بطاقة الدفع المشفّرة (يتطلّب فك التشفير باستخدام مفتاحك الخاص). راجِع دليل تشفير بيانات الدفع للحصول على تفاصيل حول التنسيق وعملية فك التشفير.