3 maja 2023 roku wycofamy interfejs Transakcje (przed 13 czerwca 2023 r. wycofujemy funkcje Conversational Actions). Więcej informacji znajdziesz w artykule Wycofanie czynności konwersacyjnych.
{// 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:
Pole wymagane do wysłania żądania instrumentu płatniczego dostarczonego przez Google. Te parametry tokenizacji zostaną wykorzystane do wygenerowania tokena płatności do użycia w transakcji. Aplikacja powinna uzyskać te parametry z bramy płatności.
Aplikacja zezwala na wykorzystywanie w transakcjach kart z dowolnej wymienionych 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 ramach transakcji.
billingAddressRequired
boolean
Jeśli ma wartość true (prawda), adres rozliczeniowy zostanie zwrócony.
PaymentMethodTokenizationParameters
Jeśli w transakcji zostaną użyte formy płatności zapisane przez użytkownika w Google, partner MUSI określić parametry tokenizacji. Partner powinien mieć możliwość pobierania tych parametrów z własnej bramy płatności.
Jeśli tokenizationType ma wartość PAYMENT_GATEWAY, lista parametrów powinna zawierać parametry specyficzne dla bramy płatności wymagane do tokenizacji formy płatności, a także parametr o nazwie „gateway” z wartością jedną z obsługiwanych przez nas bram, np. „stripe” lub „braintree”. Przykładowa konfiguracja tokenizacji w formacie JSON używana w przypadku Stripe. {
"gateway" : "stripe",
"stripe:publishableKey" : "pk_1234",
"stripe:version" : "1.5"
} Przykładowa konfiguracja tokenizacji używana dla 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 przez Adyen. {
"gateway" : "adyen",
"gatewayMerchantId" : "gateway-merchant-id"
} Jeśli tokenizationType jest ustawiony na DIRECT, integrator musi określić parametr o nazwie „publicKey”, który zawiera klucz publiczny oparty na krzywej eliptycznej w nieskompresowanym formacie ze zdefiniowanym separatorem i zakodowanym w standardzie 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 Action.
Nazwa instrumentu widoczna na rachunku. Wymagane w przypadku danych do płatności przekazywanych przez działanie. W przypadku firmy PAYMENT_CARD może to być „VISA-1234”. W przypadku BANK może to być np. „Sprawdzanie drogi-1234”. Dla LOYALTY_PROGRAM może to być „Punkty Starbucka”. W przypadku ON_FULFILLMENT może to być na przykład „płatność za odbiór”.