PaymentOptions

Opcje płatności związane z zamówieniem.

Zapis 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.
}
Pola
Pole sumy payment_option. Opcje płatności. payment_option może mieć tylko jedną z tych wartości:
googleProvidedOptions

object(GoogleProvidedPaymentOptions)

Wymagania dotyczące instrumentu płatniczego dostarczonego przez Google.

actionProvidedOptions

object(ActionProvidedPaymentOptions)

Informacje o instrumencie płatniczym dostarczonego przez działanie do wyświetlenia na paragonie.

GoogleProvidedPaymentOptions

Wymagania dotyczące formy płatności udostępnionej przez Google.

Zapis JSON
{
  "tokenizationParameters": {
    object(PaymentMethodTokenizationParameters)
  },
  "supportedCardNetworks": [
    enum(CardNetwork)
  ],
  "prepaidCardDisallowed": boolean,
  "billingAddressRequired": boolean
}
Pola
tokenizationParameters

object(PaymentMethodTokenizationParameters)

Pole wymagane, by zgłosić żądanie instrumentu płatniczego dostarczonego przez Google. Te parametry tokenizacji będą służyć do generowania tokena płatności do wykorzystania w transakcji. Aplikacja powinna pobrać te parametry ze swojej bramy płatności.

supportedCardNetworks[]

enum(CardNetwork)

Aplikacja zezwala na wykorzystywanie w transakcjach kart z dowolnej wymienionej tutaj sieci kart. Domyślnie obsługiwane są karty Amex, Visa, MC i Discover.

prepaidCardDisallowed

boolean

Jeśli ma wartość prawda, nie zezwalaj na używanie kart przedpłaconych w transakcji.

billingAddressRequired

boolean

Jeśli ma wartość true (prawda), zwrócony zostanie adres rozliczeniowy.

PaymentMethodTokenizationParameters

Jeśli w transakcji będą używane formy płatności zapisane przez użytkownika w Google, partner MUSI określić parametry tokenizacji. Partner powinien mieć możliwość pobrania tych parametrów ze swojej własnej bramy płatności.

Zapis JSON
{
  "tokenizationType": enum(PaymentMethodTokenizationType),
  "parameters": {
    string: string,
    ...
  }
}
Pola
tokenizationType

enum(PaymentMethodTokenizationType)

Wymagane.

parameters

map (key: string, value: string)

Jeśli tokenizationType ma wartość PAYMENT_GATEWAY, lista parametrów powinna zawierać parametry bramy płatności wymagane do tokenizacji formy płatności, a także parametr o nazwie „gateway”. z wartością ustawioną na jedną z obsługiwanych bram, np. „paski” czyli „drzewo mózgu”. Przykładowa konfiguracja tokenizacji używana na potrzeby Stripe w formacie JSON. { "gateway" : "stripe", "stripe:publishableKey" : "pk_1234", "stripe:version" : "1.5" } Przykładowa konfiguracja tokenizacji używana w Braintree w formacie JSON. { "gateway" : "braintree", "braintree:merchantId" : "abc" "braintree:sdkVersion" : "1.4.0" "braintree:apiVersion" : "v1" "braintree:clientKey" : "production_a12b34" "braintree:authorizationFingerprint" : "production_a12b34" } Przykładowa konfiguracja w formacie JSON używana na potrzeby Adyen. { "gateway" : "adyen", "gatewayMerchantId" : "gateway-merchant-id" } Jeśli tokenizationType ma wartość DIRECT, integrator musi określić parametr o nazwie „publicKey” który będzie zawierał klucz publiczny wykorzystujący krzywe eliptyczne w nieskompresowanym formacie ze zdefiniowanym separatorem i zakodowanym w formacie base64. Google będzie używać tego klucza publicznego do szyfrowania danych karty. Przykład parametru w formacie JSON: { "publicKey": "base64encoded..." }

Obiekt zawierający listę par "key": value. Przykład: { "name": "wrench", "mass": "1.3kg", "count": "3" }.

ActionProvidedPaymentOptions

Wymagania dotyczące formy płatności udostępnionej przez działanie.

Zapis JSON
{
  "paymentType": enum(PaymentType),
  "displayName": string
}
Pola
paymentType

enum(PaymentType)

Forma płatności. Wymagane.

displayName

string

Nazwa instrumentu widoczna na rachunku. Wymagane w przypadku danych karty podanych w działaniu. W przypadku PAYMENT_CARD może to być wartość „VISA-1234”. W przypadku BANK może to być „Chase Check-1234”. W przypadku LOYALTY_PROGRAM mogą to być „punkty Starbucka”. W przypadku ON_FULFILLMENT może to być na przykład „zapłata za dostawę”.