إعدادات معالج الدفع في Google Pay

يستند هذا المرجع إلى مخطط عنصر الإعدادات في معالج الدفع في Google Pay لبروتوكول Universal Commerce Protocol (UCP).

{
  "api_version": 2,
  "api_version_minor": 0,
  "environment": "TEST" | "PRODUCTION",
  "merchant_info": {
    "merchant_id": string,
    "merchant_name": string,
    "merchant_origin": string,
    "auth_jwt": string
  },
  "allowed_payment_methods": [
    {
      "type": "CARD",
      "parameters": {
        "allowed_auth_methods": [
          "PAN_ONLY"
        ],
        "allowed_card_networks": [
          "AMEX" | "DISCOVER" | "ELECTRON" | "ELO" | "ELO_DEBIT" | "INTERAC" | "JCB" | "MAESTRO" | "MASTERCARD" | "VISA"
        ],
        "allow_prepaid_cards": boolean,
        "allow_credit_cards": boolean,
        "assurance_details_required": boolean,
        "billing_address_required": boolean,
        "billing_address_parameters": {
          "format": "MIN" | "FULL" | "FULL-ISO3166",
          "phone_number_required": boolean
        }
      },
      "tokenization_specification": {
        "type": "PAYMENT_GATEWAY" | "DIRECT",
        "parameters": {
          ...
        }
      }
    }
  ]
}

الخصائص

الخاصية	النوع	الضرورة	الوصف
api_version	عدد صحيح	مطلوب	الإصدار الرئيسي من Google Pay API الإصدار 2 فقط هو المتاح.
api_version_minor	عدد صحيح	مطلوب	الإصدار الثانوي من Google Pay API الإصدار 0 فقط هو المتاح.
environment	سلسلة	مطلوب	بيئة Google Pay التي سيتم استخدامها TEST: بيانات اعتماد الدفع التي يتم استخدامها للاختبار فقط PRODUCTION: بيانات اعتماد الدفع الحقيقية التي يمكن تفويضها
merchant_info	عنصر	مطلوب	تفاصيل هوية التاجر
merchant_info.merchant_id	سلسلة	مطلوب	معرّف التاجر في Google Pay من Google Pay & Wallet Console. هذا المعرّف مطلوب لبيئة PRODUCTION. وهو اختياري ويتم تجاهله في بيئة TEST.
merchant_info.merchant_name	سلسلة	اختياري	اسم النشاط التجاري الذي يظهر للمستخدمين
merchant_info.merchant_origin	سلسلة	اختياري	اسم النطاق المؤهّل بالكامل على الويب الذي تتم فيه عملية الدفع (التنسيق: hostname)
merchant_info.auth_jwt	سلسلة	اختياري	رمز JWT للتفويض في سياقات تكامل معيّنة
allowed_payment_methods	عنصر[ ]	مطلوب	طرق الدفع المسموح بها لهذه المعاملة
allowed_payment_methods[].type	سلسلة	مطلوب	نوع طريقة الدفع المتاحة طريقة الدفع CARD فقط هي المتاحة.
allowed_payment_methods[].parameters	عنصر	مطلوب	المَعلمات المطلوبة لإعداد طريقة الدفع CARD
allowed_payment_methods[].parameters.allowed_auth_methods	سلسلة[ ]	مطلوب	الحقول المتاحة للمصادقة على معاملة بطاقة PAN_ONLY: يعرض رقم الحساب الأساسي (PAN) وتاريخ انتهاء صلاحية بطاقة محفوظة في "محفظة Google"
allowed_payment_methods[].parameters.allowed_card_networks	سلسلة[ ]	مطلوب	شبكات البطاقات التي يقبلها التاجر القيم المتاحة: AMEX، DISCOVER، ELECTRON، ELO، ELO_DEBIT، INTERAC، JCB، MAESTRO، MASTERCARD، VISA
allowed_payment_methods[].parameters.allow_prepaid_cards	قيمة منطقية	اختياري	يجب ضبط هذه القيمة على false إذا كنت لا تقبل البطاقات المُسبقة الدفع. القيمة التلقائية هي true.
allowed_payment_methods[].parameters.allow_credit_cards	قيمة منطقية	اختياري	يجب ضبط هذه القيمة على false إذا كنت لا تقبل بطاقات الائتمان. القيمة التلقائية هي true.
allowed_payment_methods[].parameters.assurance_details_required	قيمة منطقية	اختياري	يجب ضبط هذه القيمة على true لطلب تفاصيل تأكيد البطاقة.
allowed_payment_methods[].parameters.billing_address_required	قيمة منطقية	اختياري	يجب ضبط هذه القيمة على true إذا كنت تطلب عنوانًا لإرسال الفواتير لإكمال المعاملة.
allowed_payment_methods[].parameters.billing_address_parameters	عنصر	اختياري	المَعلمات التي تضبط عنوان إرسال الفواتير الذي يتم عرضه
allowed_payment_methods[].parameters.billing_address_parameters.format	سلسلة	اختياري	تنسيق عنوان إرسال الفواتير المطلوب لإكمال المعاملة MIN: الاسم ورمز البلد والرمز البريدي (تلقائي) FULL: الاسم وعنوان الشارع والبلدة والمنطقة ورمز البلد والرمز البريدي FULL-ISO3166: الاسم وعنوان الشارع والبلدة والمنطقة ورمز البلد والرمز البريدي وiso3166AdministrativeArea
allowed_payment_methods[].parameters.billing_address_parameters.phone_number_required	قيمة منطقية	اختياري	يجب ضبط هذه القيمة على true إذا كنت تطلب رقم هاتف لإكمال المعاملة.
allowed_payment_methods[].tokenization_specification	عنصر	مطلوب	الإعدادات التي تحدّد كيفية عرض بيانات اعتماد الدفع لك
allowed_payment_methods[].tokenization_specification.type	سلسلة	مطلوب	نوع عملية تحويل بيانات الدفع إلى رموز PAYMENT_GATEWAY: يتم استخدام هذا النوع إذا كنت تعالج الدفعات من خلال [بوابة دفع متوافقة](/pay/api#participating-processors). يعرض هذا النوع حمولة مشفّرة يتم إرسالها إلى مقدِّم خدمة الدفع. DIRECT: يتم استخدام هذا النوع إذا كنت تفك تشفير بيانات الاعتماد بنفسك (يتطلب ذلك الامتثال لمعيار أمان بيانات قطاع بطاقات الدفع (PCI DSS) من المستوى 1).
allowed_payment_methods[].tokenization_specification.parameters	عنصر	مطلوب	المَعلمات الخاصة بـ type عملية تحويل بيانات الدفع إلى رموز المحدّدة بالنسبة إلى PAYMENT_GATEWAY، المَعلمات المطلوبة هي: gateway: اسم بوابة الدفع (مثلاً، example) أي مَعلمات إضافية موضّحة لبوابة الدفع المحدّدة. بالنسبة إلى DIRECT، المَعلمات المطلوبة هي: protocolVersion: إصدار بروتوكول التشفير والتوقيع المتوقّع في بيانات اعتماد Google Pay الإصدار ECv2 فقط هو المتاح. لمزيد من المعلومات، يُرجى الاطّلاع على مقالة تشفير بيانات الدفع. publicKey: المفتاح العام للمنحنى الإهليلجي المشفّر باستخدام ترميز Base64 لمزيد من المعلومات، يُرجى الاطّلاع على قسم تنسيق المفتاح العام للتشفير.