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, 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.
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.
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.
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ę”.