A API Transactions vai ser descontinuada em 3 de maio de 2023, antes da desativação das ações de conversa em 13 de junho de 2023. Para mais informações, consulte Desativação do recurso Ações de conversa.
{// 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.}
Campos
Campo de união payment_option. Opções de pagamento. payment_option pode ser apenas de um dos tipos a seguir:
Campo obrigatório para solicitar o instrumento de pagamento fornecido pelo Google. Esses parâmetros de tokenização serão usados para gerar o token de pagamento para uso na transação. O app precisa receber esses parâmetros do gateway de pagamento.
O app permite cartões de qualquer rede de cartões listada aqui que estejam sendo usadas na transação. Por padrão, são aceitos: Amex, Visa, MC e Discover.
prepaidCardDisallowed
boolean
Se verdadeiro, não permite que cartões pré-pagos sejam usados na transação.
billingAddressRequired
boolean
Se verdadeiro, o endereço de faturamento será retornado.
PaymentMethodTokenizationParameters
O parceiro PRECISA especificar os parâmetros de tokenização se as formas de pagamento salvas pelo usuário no Google forem usadas na transação. O parceiro precisa conseguir esses parâmetros no próprio gateway de pagamento.
Se tokenizationType for definido como PAYMENT_GATEWAY, a lista de parâmetros precisará conter os parâmetros específicos do gateway de pagamento necessários para tokenizar a forma de pagamento, além do parâmetro com o nome "gateway" com o valor definido para um dos gateways compatíveis, por exemplo, "listrado" ou "braintree". Um exemplo de configuração de tokenização usada para o Stripe no formato JSON. {
"gateway" : "stripe",
"stripe:publishableKey" : "pk_1234",
"stripe:version" : "1.5"
} Uma configuração de tokenização de amostra usada para o Braintree no formato JSON. {
"gateway" : "braintree",
"braintree:merchantId" : "abc"
"braintree:sdkVersion" : "1.4.0"
"braintree:apiVersion" : "v1"
"braintree:clientKey" : "production_a12b34"
"braintree:authorizationFingerprint" : "production_a12b34"
} Um exemplo de configuração usado para Adyen no formato JSON. {
"gateway" : "adyen",
"gatewayMerchantId" : "gateway-merchant-id"
} Se tokenizationType estiver definido como DIRECT, os integradores precisarão especificar um parâmetro chamado "publicKey" que vai conter uma chave pública de curva elíptica usando o formato de ponto descompactado e codificada em base64. Essa chave pública será usada pelo Google para criptografar as informações de pagamento. Exemplo do parâmetro no formato JSON: { "publicKey": "base64encoded..." }
Um objeto com uma lista de pares "key": value. Exemplo: { "name": "wrench", "mass": "1.3kg", "count": "3" }.
ActionProvidedPaymentOptions
Requisitos para a forma de pagamento fornecida pelo Action.
Nome do instrumento exibido no recibo. Obrigatório para informações de pagamento fornecidas por ações. Para PAYMENT_CARD, pode ser "VISA-1234". Para BANK, pode ser "Chase Verification-1234". No caso do LOYALTY_PROGRAM, pode ser "Pontos do Starbuck". Para ON_FULFILLMENT, pode ser algo como "pagamento na entrega".
[null,null,["Última atualização 2024-08-21 UTC."],[[["This documentation details the deprecated Orders version 2 API for payment options associated with an order, recommending migration to Orders version 3."],["It outlines two main payment options: GoogleProvidedPaymentOptions, requiring specific parameters for using Google-saved payment methods, and ActionProvidedPaymentOptions, for payment methods provided within the Action."],["Both GoogleProvidedPaymentOptions and ActionProvidedPaymentOptions necessitate providing specific parameters and display names for a successful transaction."],["Developers should retrieve tokenization parameters from their payment gateway for GoogleProvidedPaymentOptions and define payment type and display name for ActionProvidedPaymentOptions."],["Card networks, prepaid card restrictions, and billing address requirements can be specified within GoogleProvidedPaymentOptions."]]],[]]