Configuração do gerenciador de pagamentos do Google Pay

Esta referência se baseia no esquema do objeto de configuração do processador de pagamentos do Google Pay para o Protocolo de Comércio Universal (UCP).

{
  "api_version": 2,
  "api_version_minor": 0,
  "environment": "TEST" | "PRODUCTION",
  "merchant_info": {
    "merchant_id": string,
    "merchant_name": string,
    "merchant_origin": string,
    "auth_jwt": string
  },
  "allowed_payment_methods": [
    {
      "type": "CARD",
      "parameters": {
        "allowed_auth_methods": [
          "PAN_ONLY"
        ],
        "allowed_card_networks": [
          "AMEX" | "DISCOVER" | "ELECTRON" | "ELO" | "ELO_DEBIT" | "INTERAC" | "JCB" | "MAESTRO" | "MASTERCARD" | "VISA"
        ],
        "allow_prepaid_cards": boolean,
        "allow_credit_cards": boolean,
        "assurance_details_required": boolean,
        "billing_address_required": boolean,
        "billing_address_parameters": {
          "format": "MIN" | "FULL" | "FULL-ISO3166",
          "phone_number_required": boolean
        }
      },
      "tokenization_specification": {
        "type": "PAYMENT_GATEWAY" | "DIRECT",
        "parameters": {
          ...
        }
      }
    }
  ]
}

Propriedades

Propriedade Tipo Necessidade Descrição
api_version número inteiro Obrigatório A versão principal da API Google Pay. Somente 2 é aceito.
api_version_minor número inteiro Obrigatório A versão secundária da API Google Pay. Somente 0 é aceito.
environment string Obrigatório O ambiente do Google Pay a ser usado.
  • TEST: credenciais de pagamento somente para testes.
  • PRODUCTION: credenciais de pagamento reais e autorizáveis.
merchant_info objeto Obrigatório Detalhes da identidade do comerciante.
merchant_info.merchant_id string Obrigatório Seu ID do comerciante do Google Pay no Console do Google Pay e da Carteira. Isso é obrigatório para o ambiente PRODUCTION. Ele é opcional e ignorado no ambiente TEST.
merchant_info.merchant_name string Opcional O nome comercial do comerciante visível ao usuário.
merchant_info.merchant_origin string Opcional O domínio da Web totalmente qualificado em que o pagamento é feito (formato: hostname).
merchant_info.auth_jwt string Opcional JWT de autorização para determinados contextos de integração.
allowed_payment_methods object[ ] Obrigatório As formas de pagamento permitidas para esta transação.
allowed_payment_methods[].type string Obrigatório O tipo de forma de pagamento aceita. Somente CARD é aceito.
allowed_payment_methods[].parameters objeto Obrigatório Parâmetros necessários para configurar a forma de pagamento CARD.
allowed_payment_methods[].parameters.allowed_auth_methods string[ ] Obrigatório Campos aceitos para autenticar uma transação de cartão.
  • PAN_ONLY: retorna o número da conta principal (PAN) e a data de validade de um cartão registrado na Carteira do Google.
allowed_payment_methods[].parameters.allowed_card_networks string[ ] Obrigatório As redes de cartões aceitas pelo comerciante. Valores aceitos: AMEX, DISCOVER, ELECTRON, ELO, ELO_DEBIT, INTERAC, JCB, MAESTRO, MASTERCARD, VISA.
allowed_payment_methods[].parameters.allow_prepaid_cards booleano Opcional Defina como false se você não aceitar cartões pré-pagos. O padrão é true.
allowed_payment_methods[].parameters.allow_credit_cards booleano Opcional Defina como false se você não aceitar cartões de crédito. O padrão é true.
allowed_payment_methods[].parameters.assurance_details_required booleano Opcional Defina como true para solicitar detalhes de garantia do cartão.
allowed_payment_methods[].parameters.billing_address_required booleano Opcional Defina como true se você precisar de um endereço de faturamento para concluir a transação.
allowed_payment_methods[].parameters.billing_address_parameters objeto Opcional Parâmetros que configuram o endereço de faturamento retornado.
allowed_payment_methods[].parameters.billing_address_parameters.format string Opcional Formato do endereço de faturamento necessário para concluir a transação.
  • MIN: nome, código do país e CEP/código postal (padrão).
  • FULL: nome, endereço, região administrativa, região, código do país e código postal.
  • FULL-ISO3166: nome, endereço, localidade, região, código do país, código postal e iso3166AdministrativeArea.
allowed_payment_methods[].parameters.billing_address_parameters.phone_number_required booleano Opcional Defina como true se você precisar de um número de telefone para concluir a transação.
allowed_payment_methods[].tokenization_specification objeto Obrigatório Configuração que define como as credenciais de pagamento são retornadas para você.
allowed_payment_methods[].tokenization_specification.type string Obrigatório O tipo de tokenização.
  • PAYMENT_GATEWAY: usado se você processar pagamentos por um [gateway compatível](/pay/api#participating-processors). Retorna um payload criptografado para ser transmitido ao seu PSP.
  • DIRECT: usado se você descriptografar as credenciais por conta própria (requer conformidade com o PCI DSS nível 1).
allowed_payment_methods[].tokenization_specification.parameters objeto Obrigatório Parâmetros específicos para a tokenização type selecionada.

Para PAYMENT_GATEWAY, os parâmetros obrigatórios são: Para DIRECT, os parâmetros obrigatórios são: