Elenco di controllo dell'integrazione

Utilizza il seguente elenco di controllo per assicurarti di aver completato tutti i passaggi richiesti nell'integrazione web.

Informazioni sull'ambiente di test

Una configurazione di test dell'API Google Pay non restituisce informazioni di pagamento live e addebitabili, ma ti consente di testare gli elementi del flusso di lavoro di acquisto. Di seguito sono riportati gli elementi testabili:

  • Pagine di conferma
  • Ricevute
  • Indirizzo di fatturazione (facoltativo)
  • Numero di telefono per la fatturazione (facoltativo)
  • (Facoltativo) Indirizzo di spedizione
  • Indirizzo email (facoltativo)

Per utilizzare un ambiente di test con una risposta di esempio dei dati di pagamento, inizializza un nuovo PaymentsClient con un oggetto JavaScript che contiene una proprietà dell'ambiente impostata su TEST.

Di seguito è riportato un esempio di codice: 
var paymentsClient =
    new google.payments.api.PaymentsClient({environment: 'TEST'});

Testare con la console per sviluppatori del browser

Testa il tuo sito web sull'ultima versione di un browser supportato. Per farlo, apri gli strumenti per sviluppatori del browser per visualizzare i messaggi della console relativi al tuo sito web. I messaggi includono errori o avvisi della libreria client JavaScript dell'API Google Pay. L'API Google Pay supporta Google Chrome, Mozilla Firefox, Apple Safari, Microsoft Edge, Opera e UCWeb UC Browser.

Dopo aver chiamato loadPaymentData(), nella finestra di dialogo di selezione dei pagamenti Google potrebbero essere visualizzati errori aggiuntivi. Quando fai clic su Continua o Ok dopo aver visualizzato il messaggio di errore, potrebbero essere restituiti dettagli aggiuntivi nel Promise rifiutato gestito dal tuo sito.

Eseguire il test su un dispositivo compatibile

Sebbene l'API Google Pay sia disponibile in molti mercati, le carte tokenizzate sono disponibili solo in un sottoinsieme di paesi. Se le carte tokenizzate sono impostate come metodo di pagamento consentito, testale su un dispositivo Android con Chrome per Android versione 59 o successive e Google Play Services versione 16.0.0 o successive. Se il tuo metodo di pagamento è supportato nel tuo paese e dalla tua banca emittente, prova con una carta memorizzata nell'app Google Pay.

Per visualizzare gli errori e gli avvisi della console Chrome per Android, esegui il test con il debug remoto da Chrome per computer. Per ulteriori informazioni sui possibili errori, visualizza i log del tuo dispositivo Android. Potresti essere in grado di visualizzare i log degli errori con la finestra degli strumenti Logcat in Android Studio, con lo strumento a riga di comando adb logcat o all'interno di un report di bug di Android. Per visualizzare i messaggi di errore relativi all'API Google Pay, cerca WalletMerchantError.

Di seguito è riportato un esempio di codice:

adb logcat -s WalletMerchantError

Testare l'integrazione

Prima di inviare l'integrazione a Google per la convalida con un PaymentsClient configurato per un ambiente TEST, assicurati di aver soddisfatto i criteri di uscita per ciascuno dei seguenti controlli funzionali e di branding.

1. Nozioni di base
Assicurati che i controlli e i controlli del rischio esistenti per le transazioni con carta o PAN vengano applicati anche alle transazioni Google Pay. I controlli di convalida e frode di Google Pay non hanno lo scopo di sostituire le tue procedure di gestione del rischio.
Se attivi in modo selettivo 3D Secure (autenticazione avanzata) per le normali transazioni con carta in base ai criteri di rischio, assicurati di utilizzare gli stessi criteri di rischio per attivare 3D Secure per le transazioni con PAN PAN_ONLY di Google Pay.
Assicurati di aver letto e di essere pronto ad accettare i nostri Termini di servizio. La registrazione all'API Google Pay richiede che il tuo indirizzo email sia associato a un Account Google e, preferibilmente, a un indirizzo email aziendale associato al tuo dominio aziendale, ad esempio "admin@myownpersonaldomain.com". Seleziona Usa invece il mio indirizzo email corrente nel flusso di creazione dell'Account Google per associare il tuo indirizzo email a un Account Google.
Utilizzare i dati ricevuti dall'API Google Pay solo per elaborare le transazioni. Tutti gli altri casi d'uso richiedono un consenso esplicito separato da parte dell'utente.
Verifica le reti di carte e i metodi di autenticazione delle carte accettati dal tuo elaboratore dei pagamenti nel tuo paese.
Se completi un'integrazione DIRECT tokenizationSpecification type, devi ruotare annualmente la chiave di crittografia pubblica e fornire l'attestazione PCI a Google utilizzando Google Pay & Wallet Console. L'attestazione PCI può essere inviata da una terza parte o da un Qualified Security Assessor certificato dal PCI Security Standards Council e approvato da un Approved Vendor o da un Qualified Assessor.

2. Test del brand
Utilizza i nostri asset approvati e rispetta tutti gli elementi delle nostre linee guida per il brand.
Assicurati che il pulsante di pagamento Google Pay venga visualizzato solo dopo che il tuo sito ha confermato la capacità dell'utente di pagare tramite la funzione isReadyToPay().
Verifica che le dimensioni del pulsante di pagamento Google Pay visualizzato corrispondano a quelle di pulsanti ed elementi simili nella pagina.
Scegli un pulsante appropriato in base al colore di sfondo dell'area in cui viene visualizzato.

3. Test funzionali
Verifica che loadPaymentData() venga chiamato in modo sincrono quando fai clic sul pulsante di pagamento Google Pay e che mantenga il comportamento di attivazione dell'utente del browser che consente all'API Google Pay di visualizzare un foglio di pagamento. Verifica che il modulo di pagamento Google Pay non sia bloccato dai blocchi popup.

Quando richiedi il tipo di metodo di pagamento CARD con l'autenticazione della carta PAN_ONLY, completa i seguenti passaggi per eseguire il test delle carte memorizzate:

  1. Se applicabile, rimuovi tutte le carte registrate da pay.google.com.
  2. Torna all'integrazione.
  3. Fai clic su Google Pay.
  4. Verifica di visualizzare l'opzione per aggiungere una carta.
  5. Aggiungi una carta di una rete supportata, come definito in parameters.allowedCardNetworks.
  6. Verifica di visualizzare la carta aggiunta con il logo della rete nel selettore.

Il seguente test è applicabile solo a Chrome su Android.

Quando richiedi il tipo di metodo di pagamento CARD con l'autenticazione della carta CRYPTOGRAM_3DS, completa i seguenti passaggi per eseguire il test del token del dispositivo Android:

  1. Verifica che l'emittente della tua carta sia supportata e aggiungi una carta idonea nell' applicazione Google Pay per Android.
  2. Torna all'integrazione.
  3. Fai clic sul pulsante di pagamento Google Pay.
  4. Verifica che la carta aggiunta, con la grafica della carta, sia visualizzata nel selettore.

Se confermi che il tuo processore supporta l'autenticazione della carta 3D Secure, puoi procedere, anche se non hai a disposizione un token del dispositivo Android come utente Android o titolare della carta.

Se richiedi un indirizzo di spedizione, testa l'elaborazione dell'indirizzo di spedizione in vari stati di completamento, ad esempio:

  • Varianze di un nome completo da analizzare in campi strutturati, ad esempio "Giovanni", "Giovanni Rossi" e "Maria Rossi Bianchi".
  • Analizza con precisione tutte le righe dell'indirizzo restituite dall'API Google Pay, che potrebbero superare il numero totale di righe dell'indirizzo generalmente raccolte nel flusso di pagamento standard.
  • Verifica che il componente paese restituito dell'indirizzo corrisponda alle destinazioni di spedizione supportate del tuo sito. Se hai specificato limitazioni alla spedizione, testale: inserisci un indirizzo di spedizione non supportato e non consentito nel nostro foglio di pagamento e verifica se le limitazioni funzionano.

Se hai implementato il supporto per Autorizza pagamenti, verifica quanto segue:

  • Quando l'autenticazione di un pagamento non va a buon fine, viene restituito un ERROR transactionState e PaymentDataError con l'intent PAYMENT_AUTHORIZATION.

Se hai implementato il supporto degli aggiornamenti dinamici dei prezzi, completa i seguenti passaggi:

  1. Aggiungi i dati della carta e dell'indirizzo nel foglio di pagamento.
  2. Aggiorna le opzioni di spedizione, l'elenco degli ordini e il prezzo totale.
    3. Importante: assicurati che il prezzo totale corrisponda all'importo della transazione. In caso contrario, può influire sul valore dell'indicatore di commercio elettronico (ECI) e sulla parte responsabile.
  3. Aggiungi e seleziona un indirizzo di spedizione.
  4. Aggiorna le opzioni di spedizione, l'elenco degli ordini e il prezzo totale.
  5. Seleziona un'opzione di spedizione.
  6. Aggiorna l'elenco degli ordini e il prezzo totale.
  7. Convalida i risultati:
    • Se l'indirizzo di spedizione non dispone di opzioni di spedizione disponibili, verifica di ricevere PaymentDataError con l'intent SHIPPING_ADDRESS.
    • Se l'opzione di spedizione selezionata non è valida, verifica di ricevere PaymentDataError con l'intent SHIPPING_OPTION.
    • Se l'autenticazione del pagamento non va a buon fine, verifica di ricevere ERROR transactionState e PaymentDataError con l'intent PAYMENT_AUTHORIZATION.
Se hai bisogno di un numero di telefono, richiedilo all'indirizzo di fatturazione. Poi, verifica se riesci ad analizzare e memorizzare il numero di telefono negli standard dei dati del tuo sito web con formati diversi come "+8005550100", "18005550100" e "(800) 555-0100".
Assicurati che Google Pay venga visualizzato alla pari con altri metodi di pagamento di terze parti.
Per gli utenti che in precedenza hanno selezionato Google Pay al momento del pagamento e hanno indicato Google Pay come preferenza per il pagamento all'interno del tuo sito web, Google Pay deve essere impostato come metodo di pagamento predefinito per l'acquisto successivo.
All'utente deve essere mostrato un prezzo finale prima che la transazione venga elaborata. Se l'importo da addebitare è variato in base ai dati ricevuti dall'API Google Pay, devi mostrare una pagina di conferma con un prezzo finale.