Configurazione del gestore dei pagamenti Google Pay

Questo riferimento si basa sullo schema dell'oggetto di configurazione per il gestore di pagamento Google Pay per Universal Commerce Protocol (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": {
          ...
        }
      }
    }
  ]
}

Proprietà

Proprietà Tipo Necessità Descrizione
api_version integer Obbligatorio La versione principale dell'API Google Pay. È supportata solo la versione 2.
api_version_minor integer Obbligatorio La versione secondaria dell'API Google Pay. È supportata solo la versione 0.
environment stringa Obbligatorio L'ambiente Google Pay da utilizzare.
  • TEST: credenziali di pagamento solo per i test.
  • PRODUCTION: credenziali di pagamento reali e autorizzabili.
merchant_info oggetto Obbligatorio Dettagli sull'identità del commerciante.
merchant_info.merchant_id stringa Obbligatorio Il tuo ID commerciante Google Pay dalla Console di Google Pay e Wallet. Questo è obbligatorio per l'ambiente PRODUCTION. È facoltativo e viene ignorato nell'ambiente TEST.
merchant_info.merchant_name stringa Facoltativo Il nome commerciale del commerciante visibile agli utenti.
merchant_info.merchant_origin stringa Facoltativo Il dominio web completo in cui si svolge l'acquisto (formato: hostname).
merchant_info.auth_jwt stringa Facoltativo JWT di autorizzazione per determinati contesti di integrazione.
allowed_payment_methods oggetto[ ] Obbligatorio I metodi di pagamento consentiti per questa transazione.
allowed_payment_methods[].type stringa Obbligatorio Il tipo di metodo di pagamento supportato. È supportato solo CARD.
allowed_payment_methods[].parameters oggetto Obbligatorio Parametri necessari per configurare il metodo di pagamento CARD.
allowed_payment_methods[].parameters.allowed_auth_methods stringa[ ] Obbligatorio Campi supportati per autenticare una transazione con carta.
  • PAN_ONLY: restituisce il numero di conto principale (PAN) e la data di scadenza di una carta registrata in Google Wallet.
allowed_payment_methods[].parameters.allowed_card_networks stringa[ ] Obbligatorio I circuiti di carte supportati dal commerciante. Valori supportati: AMEX, DISCOVER, ELECTRON, ELO, ELO_DEBIT, INTERAC, JCB, MAESTRO, MASTERCARD, VISA.
allowed_payment_methods[].parameters.allow_prepaid_cards booleano Facoltativo Imposta su false se non supporti le carte prepagate. Il valore predefinito è true.
allowed_payment_methods[].parameters.allow_credit_cards booleano Facoltativo Imposta su false se non supporti le carte di credito. Il valore predefinito è true.
allowed_payment_methods[].parameters.assurance_details_required booleano Facoltativo Imposta su true per richiedere i dettagli di garanzia della carta.
allowed_payment_methods[].parameters.billing_address_required booleano Facoltativo Imposta su true se richiedi un indirizzo di fatturazione per completare la transazione.
allowed_payment_methods[].parameters.billing_address_parameters oggetto Facoltativo Parametri che configurano l'indirizzo di fatturazione restituito.
allowed_payment_methods[].parameters.billing_address_parameters.format stringa Facoltativo Formato dell'indirizzo di fatturazione richiesto per completare la transazione.
  • MIN: nome, codice paese e codice postale (valore predefinito).
  • FULL: nome, indirizzo, località, regione, codice paese e codice postale.
  • FULL-ISO3166: nome, indirizzo, località, regione, codice paese, codice postale e iso3166AdministrativeArea.
allowed_payment_methods[].parameters.billing_address_parameters.phone_number_required booleano Facoltativo Imposta su true se richiedi un numero di telefono per completare la transazione.
allowed_payment_methods[].tokenization_specification oggetto Obbligatorio Configurazione che definisce la modalità di restituzione delle credenziali di pagamento.
allowed_payment_methods[].tokenization_specification.type stringa Obbligatorio Il tipo di tokenizzazione.
  • PAYMENT_GATEWAY: utilizzato se elabori i pagamenti tramite un [gateway supportato](/pay/api#participating-processors). Restituisce un payload criptato da passare al tuo PSP.
  • DIRECT: utilizzato se decripti tu stesso le credenziali (richiede la conformità PCI DSS di livello 1).
allowed_payment_methods[].tokenization_specification.parameters oggetto Obbligatorio Parametri specifici per il type di tokenizzazione selezionato.

Per PAYMENT_GATEWAY, i parametri obbligatori sono: Per DIRECT, i parametri obbligatori sono: