PaymentOptions

خيارات الدفع المرتبطة بطلب معيّن

تمثيل JSON 
{

  // Union field payment_option can be only one of the following:
  "googleProvidedOptions": {
    object(GoogleProvidedPaymentOptions)
  },
  "actionProvidedOptions": {
    object(ActionProvidedPaymentOptions)
  }
  // End of list of possible types for union field payment_option.
}
الحقول
حقل الاتحاد payment_option. خيارات الدفع. يمكن أن يكون payment_option واحدًا فقط مما يلي:
googleProvidedOptions

object(GoogleProvidedPaymentOptions)

متطلبات وسيلة الدفع التي تقدّمها Google

actionProvidedOptions

object(ActionProvidedPaymentOptions)

معلومات عن وسيلة دفع يوفّرها الإجراء ليتم عرضها عند الإيصال

GoogleProvidedPaymentOptions

متطلبات طريقة الدفع التي تقدّمها Google

تمثيل JSON 
{
  "tokenizationParameters": {
    object(PaymentMethodTokenizationParameters)
  },
  "supportedCardNetworks": [
    enum(CardNetwork)
  ],
  "prepaidCardDisallowed": boolean,
  "billingAddressRequired": boolean
}
الحقول
tokenizationParameters

object(PaymentMethodTokenizationParameters)

حقل مطلوب لطلب وسيلة الدفع التي تقدّمها Google سيتم استخدام مَعلمات إنشاء الرموز المميّزة هذه لإنشاء رمز مميّز للدفع من أجل استخدامه في المعاملات. من المفترض أن يحصل التطبيق على هذه المعلمات من بوابة الدفع.

supportedCardNetworks[]

enum(CardNetwork)

يتيح التطبيق استخدام البطاقات من أيّ شبكة بطاقات مدرَجة هنا في المعاملات. يمكن تلقائيًا استخدام Amex وVisa وMC وDiscover.

prepaidCardDisallowed

boolean

إذا كانت هذه القيمة صحيحة، يُرجى عدم السماح باستخدام البطاقات المدفوعة مسبقًا في المعاملة.

billingAddressRequired

boolean

في حال اختيار القيمة "صحيح"، سيتم عرض عنوان إرسال الفواتير.

PaymentMethodTokenizationParameters

يجب أن يحدّد الشريك مَعلمات إنشاء الرموز المميّزة إذا كانت طرق الدفع التي حفظها المستخدم لدى Google سيتم استخدامها في المعاملة. ويجب أن يتمكن الشريك من الحصول على هذه المعلمات من بوابة الدفع الخاصة به.

تمثيل JSON 
{
  "tokenizationType": enum(PaymentMethodTokenizationType),
  "parameters": {
    string: string,
    ...
  }
}
الحقول
tokenizationType

enum(PaymentMethodTokenizationType)

مطلوب.

parameters

map (key: string, value: string)

في حال ضبط SpamizationType على PAYMENT_GATEWAY، يجب أن تحتوي قائمة المَعلمات على المَعلمات الخاصة ببوابة الدفع المطلوبة لتحويل طريقة الدفع إلى رمز مميّز، بالإضافة إلى المَعلمة التي تحمل الاسم "البوابة". مع ضبط القيمة على إحدى المداخل المتوافقة، مثل "Stripe" أو "braintree". نموذج من إعدادات الترميز المستخدَمة في Stripe بتنسيق JSON. { "gateway" : "stripe", "stripe:publishableKey" : "pk_1234", "stripe:version" : "1.5" } نموذج من إعدادات الترميز المستخدَم في Braintree بتنسيق JSON. { "gateway" : "braintree", "braintree:merchantId" : "abc" "braintree:sdkVersion" : "1.4.0" "braintree:apiVersion" : "v1" "braintree:clientKey" : "production_a12b34" "braintree:authorizationFingerprint" : "production_a12b34" } نموذج من الإعدادات مستخدمة لبرنامج Adyen بتنسيق JSON. { "gateway" : "adyen", "gatewayMerchantId" : "gateway-merchant-id" } في حال ضبط نوع رمز مميّز على "مباشر"، على جهات الدمج تحديد مَعلمة باسم "publicKey" والذي يحتوي على مفتاح عام لميزة "منحنى إهليلجي" باستخدام تنسيق النقطة غير المضغوط وترميز base64. ستستخدم Google هذا المفتاح العام لتشفير معلومات الدفع. مثال على المَعلمة بتنسيق JSON: { "publicKey": "base64encrypt..." }

عنصر يحتوي على قائمة بأزواج "key": value مثال: { "name": "wrench", "mass": "1.3kg", "count": "3" }

ActionProvidedPaymentOptions

متطلبات طريقة الدفع المقدَّمة من الإجراء:

تمثيل JSON 
{
  "paymentType": enum(PaymentType),
  "displayName": string
}
الحقول
paymentType

enum(PaymentType)

طريقة الدفع مطلوب.

displayName

string

اسم الآلة المعروضة في الإيصال. مطلوب لمعلومات الدفع المقدّمة من الإجراء. بالنسبة إلى PAYMENT_CARD، قد تكون القيمة هي "VISA-1234". بالنسبة إلى BANK، يمكن أن يكون هذا الحقل "Chase Check-1234". بالنسبة إلى LOYALTY_PROGRAM، قد تكون هذه القيمة هي "نقاط Starbuck". بالنسبة إلى ON_FULFILLMENT، قد يكون الأمر مثل "الدفع عند التسليم".