Domande frequenti
Mantieni tutto organizzato con le raccolte
Salva e classifica i contenuti in base alle tue preferenze.
Questa pagina fornisce informazioni generali e domande frequenti sull'API Google Pay.
Informazioni sull'API Google Pay
Google Pay consente di effettuare pagamenti senza problemi per la tua app e il tuo sito web. Con l'API Google Pay, i tuoi clienti possono utilizzare le carte salvate nei loro Account Google per effettuare il pagamento senza problemi nelle tue app e sui tuoi siti.
L'API Google Pay può restituire carte o token di rete.
Fatturazione ricorrente e abbonamenti
Il supporto della fatturazione ricorrente è vincolato al metodo di pagamento restituito nella risposta dell'API Google Pay. Per la fatturazione ricorrente è possibile utilizzare sia le carte tokenizzate sia le carte memorizzate. Per elaborare
la fatturazione ricorrente, il commerciante non deve chiamare la nostra API a una cadenza. Invece, la credenziale di pagamento viene memorizzata sul lato del commerciante per i pagamenti ricorrenti. Il commerciante utilizza le API del gateway di pagamento
per gestire la fatturazione ricorrente.
Google Pay supporta i pagamenti ricorrenti se le seguenti affermazioni sono vere:
I commercianti rispettano le regole del circuito, ad esempio le transazioni avviate dal commerciante.
I termini di pagamento vengono divulgati e accettati dall'utente all'interno del percorso di acquisto del commerciante.
Supportiamo anche la fatturazione ricorrente con importi variabili. Ad esempio, sono supportate le bollette telefoniche mensili degli operatori di telefonia mobile. Per saperne di più, i commercianti devono contattare il rappresentante del loro gateway di pagamento.
Ricarica automatica
Per elaborare un addebito di ricarica automatica per lo stesso costo, il commerciante non deve chiamare la nostra API ogni volta. La credenziale di pagamento viene memorizzata sul lato commerciante e riutilizzata. Per saperne di più,
i commercianti devono contattare il rappresentante del gateway di pagamento.
Storni di addebito
I commercianti possono gestire gli storni delle transazioni per annullamenti, rimborsi o contestazioni nello stesso modo in cui gestiscono gli storni di addebito per altre forme di pagamento. Per saperne di più, i commercianti devono contattare il rappresentante del proprio elaboratore.
Raccolta di donazioni
Le organizzazioni non profit (ONP) approvate possono integrare l'API Google Pay per raccogliere donazioni,
se, e solo se, forniscono la documentazione per dimostrare, certificare e convalidare il loro
status di non profit. Ad esempio, le organizzazioni non profit statunitensi devono fornire una prova valida dello stato 501(c)3 dell'IRS per essere idonee.
Termini e norme
Termini di servizio di Google Pay
Tutti i commercianti devono accettare e rispettare i Termini di servizio di Google Pay.
Le nostre norme relative ai giochi e scommesse sono definite nelle nostre Norme di utilizzo accettabile dell'API Google Pay.
Le nostre norme relative a giochi e scommesse possono variare di volta in volta. Tutti i contenuti inviati sono soggetti a revisione e
approvazione.
Accettiamo integrazioni di giochi e scommesse da società con sede nei seguenti paesi:
Australia
Austria
Canada
Repubblica Ceca
Francia
Georgia
Germania
Grecia
Ungheria
Irlanda
Italia
Giappone
Paesi Bassi
Polonia
Portogallo
Romania
Spagna
Svezia
Regno Unito
In una fase successiva, potremmo decidere di estendere l'assistenza oltre il livello attuale.
Per ottenere l'accesso in produzione all'API Google Pay per le integrazioni di giochi e scommesse, è necessario soddisfare una serie di prerequisiti:
Se hai un'integrazione di giochi e scommesse solo per Android con sede in uno dei paesi menzionati in precedenza, devi
rispettare le
norme relative a giochi e scommesse di Google Play
e completare prima la
procedura di verifica
di Google Play. Possiamo quindi valutare la tua integrazione solo per Android per l'accesso in produzione all'API Google Pay.
Se hai un'integrazione di giochi e scommesse solo sul web con sede in uno dei paesi sopra menzionati, devi inviare una licenza autorizzata per dimostrare la tua idoneità a fornire servizi di giochi e scommesse nel paese durante la procedura di onboarding con l'API Google Pay. Possiamo quindi valutare la tua integrazione solo web
per l'accesso in produzione all'API Google Pay.
Se hai un'integrazione di giochi e scommesse per Android e web in uno dei paesi menzionati in precedenza, devi
rispettare le
norme relative a giochi e scommesse di Google Play
e completare prima la
procedura di verifica
di Google Play. Possiamo quindi valutare le tue integrazioni Android e web per l'accesso in produzione all'API Google Pay.
Paesi con condizioni o limitazioni specifiche
Le integrazioni di giochi e scommesse sono consentite per i paesi elencati se soddisfano i seguenti criteri:
Paese
Idoneità all'integrazione con Android
Idoneità all'integrazione web
Bulgaria
Sì, con limitazioni:
Le app che reindirizzano a un sito web sono idonee.
Le app che non reindirizzano a un sito web sono vietate.
Sì
Cipro
Sì, con limitazioni:
La lotteria statale è idonea.
OPAP Cyprus Limited è idonea.
I casinò online sono vietati.
Le slot machine sono vietate.
Le scommesse ippiche sono vietate.
Le scommesse sulle corse dei cani sono vietate.
Le scommesse con spread sono vietate.
Le piattaforme di scommesse sono vietate.
Sì, con limitazioni:
La lotteria statale è idonea.
OPAP Cyprus Limited è idonea.
I casinò online sono vietati.
Le slot machine sono vietate.
Le scommesse ippiche sono vietate.
Le scommesse sulle corse dei cani sono vietate.
Le scommesse con spread sono vietate.
Le piattaforme di scommesse sono vietate.
Finlandia
Sì, con limitazioni:
Veikkaus Oy è idonea.
Sì, con limitazioni:
Veikkaus Oy è idonea.
Kazakistan
Sì, con limitazioni:
Le lotterie sono idonee.
Le scommesse sportive sono idonee.
I totalizzatori sono idonei.
I casinò online sono vietati.
I casinò elettronici sono vietati.
Sì, con limitazioni:
Le lotterie sono idonee.
Le scommesse sportive sono idonee.
I totalizzatori sono idonei.
I casinò online sono vietati.
I casinò elettronici sono vietati.
Polonia
No
Sì, con limitazioni:
I fornitori di giochi e scommesse autorizzati sono idonei.
Sudafrica
Sì, con limitazioni:
Le scommesse sportive online sono idonee.
Sì, con limitazioni:
Le scommesse sportive online sono idonee.
Se espandi l'API Google Pay in un paese per cui non hai ricevuto l'approvazione in precedenza,
contattaci per ottenere l'approvazione per l'espansione.
Tieni presente che dovrai fornire una licenza per giochi e scommesse autorizzata per ogni paese in cui
intendi offrire servizi correlati a giochi e scommesse. Non consentiamo l'utilizzo dell'API Google Pay per servizi di giochi e scommesse rivolti a minorenni o a persone a cui è vietato giocare e scommettere ai sensi delle leggi locali.
Preparati a condividere una licenza pertinente durante l'onboarding per convalidare il tuo caso d'uso in ambito sanitario. Tutti i contenuti inviati sono soggetti a revisione e approvazione.
Tieni a portata di mano una licenza pertinente da condividere durante l'onboarding per convalidare il tuo caso d'uso dei servizi finanziari. Tutti i contenuti inviati sono soggetti a revisione e approvazione.
Domande frequenti di carattere generale
Le seguenti domande frequenti si applicano ai commercianti:
Utilizzo un PSP principale per gestire tutti i rischi e l'autenticazione forte del cliente. Cosa devo sapere su GPay?
L'API Google Pay restituisce i metodi di pagamento in un payload firmato e criptato. I metodi di pagamento restituiti sono costituiti da PAN o carte tokenizzate composte da PAN del dispositivo (DPAN) e crittogrammi.
I payload delle carte tokenizzate vengono elaborati senza ulteriori passaggi o verifiche.
I payload delle carte costituiti da PAN richiedono 3D Secure tramite una soluzione interna o fornita da un PSP.
Se il tuo PSP gestisce tutta la logica di rischio e SCA, assicurati che l'integrazione dell'API Google Pay includa le seguenti proprietà:
merchantInfo.merchantName (Android, Web): il nome del commerciante viene visualizzato nel foglio di pagamento.
transactionInfo.countryCode (Android, web): indica dove viene elaborata la transazione. Devi specificare il paese della banca acquirente.
transactionInfo.totalPrice (Android, Web): il valore monetario totale della transazione con una precisione decimale facoltativa di due cifre decimali.
Come faccio a ottenere un ID commerciante Google?
Puoi ottenere un ID commerciante Google dopo che Google avrà approvato il tuo sito web. Per avviare la procedura, accedi a Google Pay & Wallet Console e crea un'integrazione dell'API Google Pay. Devi fornire un elenco di domini completi insieme ai sottodomini, che ti aiutano a chiamare l'API Google Pay.
Possiamo utilizzare un unico ID commerciante per più brand e canali (web/app)?
Sì, l'utilizzo di un singolo ID commerciante su più brand e piattaforme (come web e Android)
è supportato e generalmente consigliato per semplificare la riconciliazione.
In che modo i commercianti possono promuovere l'accettazione di Google Pay nelle loro app e nei loro siti presso i propri utenti?
Per evidenziare il supporto di Google Pay, assicurati di utilizzare gli asset disponibili nelle nostre linee guida per il brand per Android e per il web.
Se hai un'integrazione Android, puoi indicare nella descrizione del Play Store che ora
supporti Google Pay. Per le integrazioni web, puoi aggiungere una descrizione direttamente al sito web del commerciante.
Le piattaforme di e-commerce possono supportare Google Pay?
Sì, l'API Google Pay supporta l'onboarding delle piattaforme di e-commerce. Gli elaboratori dei pagamenti, i gateway o i partner di piattaforme di e-commerce che ospitano una pagina di checkout per conto dei loro commercianti possono utilizzare la funzionalità di checkout ospitato di Google Pay.
Quali fornitori di servizi di pagamento supportano Google Pay?
Per trovare un elenco dei processori che supportano Google Pay, consulta il nostro elenco di processori Google Pay.
Quali paesi e regioni sono supportati per Google Pay?
Dai un'occhiata al nostro
elenco dei paesi supportati che utilizzano
Google Pay per i pagamenti online o nelle app.
Quali paesi e regioni sono supportati per i token Google Pay (CRYPTOGRAM_3DS)?
Qual è la differenza tra la Fatturazione in-app di Google Play e l'API Google Pay?
Gli sviluppatori di Google Play che vendono servizi e prodotti digitali su app per Android devono utilizzare la Fatturazione in-app di Google Play, come specificato nel Centro norme per gli sviluppatori di Play. Esempi di Fatturazione in-app includono prodotti di gioco virtuali, funzionalità o contenuti delle app e prodotti software cloud. Per scoprire di più sulla fatturazione in-app, consulta la pagina Panoramica di Fatturazione Google Play.
Se utilizzata nelle app, l'API Google Pay è disponibile solo per prodotti e servizi fisici.
Google Pay addebita commissioni?
Google Pay non addebita costi aggiuntivi a utenti, commercianti e sviluppatori per l'utilizzo dell'API Google Pay per i pagamenti. I commercianti, in particolare, continuano a pagare le commissioni di elaborazione al proprio
elaboratore dei pagamenti.
Cosa fa Google per convalidare le credenziali e prevenire le frodi?
Tutte le carte aggiunte a Google vengono sottoposte a un'autorizzazione di verifica per convalidare i dettagli della carta, che
includono il codice di verifica della carta (CVC). Google gestisce anche un motore di rischio proprietario basato su dati degli strumenti, profili degli Account Google, cronologia acquisti, posizioni e informazioni sui dispositivi.
Tuttavia, i commercianti devono continuare a utilizzare i loro attuali strumenti di analisi del rischio e delle frodi con le transazioni Google Pay.
Google Pay è supportato nelle WebView delle app mobile?
Le WebView di Android supportano completamente Google Pay e simulano l'esperienza web mobile, a condizione che tu aggiunga
la dipendenza WebKit necessaria. Tuttavia, nelle WebView di iOS, l'API isReadyToPay restituirà sempre
false a causa delle limitazioni di iOS sui cookie di terze parti. Sia l'app per Android sia il dominio del sito web
all'interno di WebView devono essere approvati per l'accesso in produzione. Per dettagli specifici sull'implementazione, consulta la documentazione Utilizzo di Android WebView o Utilizzo di iOS WKWebView.
Il mio processore non è presente nell'elenco. Posso comunque eseguire l'integrazione con Google Pay?
Google Pay instaura continuamente partnership con piattaforme di e-commerce ed elaboratori dei pagamenti.
Se non riesci a trovare il tuo processore all'indirizzo g.co/pay/processors,
puoi inviare una richiesta. Riceverai una notifica quando il processore sarà disponibile.
Come faccio ad attivare Google Pay se ho già un elaboratore dei pagamenti o un fornitore di piattaforma di pagamento?
Come faccio a offrire Google Pay su larga scala ai miei commercianti, se sono un elaboratore di pagamenti supportato?
Gli elaboratori dei pagamenti supportati possono implementare la nostra soluzione di checkout ospitata per le integrazioni web.
Il pagamento ospitato consente ai tuoi clienti di offrire Google Pay ai loro clienti ed evitare l'onboarding individuale
con Google Pay.
Per iniziare, devi prima eseguire l'onboarding come elaboratore dei pagamenti supportato. Per integrare la soluzione di pagamento in hosting, rivolgiti al tuo referente tecnico di Google che ti ha aiutato con l'onboarding.
In che modo Google Pay può gestire diverse opzioni di spedizione e prezzi diversi per i miei
utenti se offro la spedizione nel flusso di checkout?
Per le integrazioni web, devi richiedere un indirizzo di spedizione e mostrare diverse opzioni di spedizione
e prezzi all'interno dell'oggetto
PaymentDataRequest,
dell'oggetto PaymentOptions
e dell'oggetto
PaymentDataCallbacks. Per un esempio di situazione, consulta la demo Aggiornamento dinamico dei prezzi.
Per le integrazioni Android, è necessario un indirizzo di spedizione all'interno dell'oggetto
PaymentDataRequest.
Come faccio a ricevere i pagamenti degli acquisti effettuati con Google Pay?
L'API Google Pay facilita le transazioni trasferendo i dati di pagamento dagli utenti al tuo
fornitore di servizi di pagamento. Non fa parte del flusso di denaro ed è progettato per essere integrato nell'infrastruttura di pagamento esistente.
Quali sono i requisiti per ottenere l'accesso in produzione?
I commercianti devono creare un profilo dell'attività nella console Google Pay & Wallet e caricare screenshot
del flusso di acquisto per la revisione. Ogni dominio che ospita l'API Google Pay deve essere inviato singolarmente per l'approvazione, poiché i domini con caratteri jolly (ad es. *.merchant.com) non sono accettati.
Per saperne di più, consulta la pagina Pubblica l'integrazione per Android e/o Web.
Come faccio a sapere lo stato della mia richiesta di integrazione e se devo apportare modifiche dopo la procedura di revisione?
Dopo aver inviato l'integrazione dell'API Google Pay per la revisione, riceverai un'email con i risultati. Se l'integrazione rispetta le nostre Norme di utilizzo accettabile e le linee guida per il brand, viene approvata e lo stato viene visualizzato come Attivo nella console Google Pay & Wallet. Se
sono necessarie modifiche, lo stato indica Sono necessarie ulteriori informazioni e l'email fornisce i
dettagli di ciò che deve essere corretto prima di inviare nuovamente la richiesta. Per qualsiasi domanda relativa all'invio, puoi
contattare l'assistenza direttamente da Google Pay & Wallet Console.
Come posso risolvere i problemi relativi all'integrazione dell'API Google Pay se visualizzo un
messaggio di errore?
Per i codici di errore e le soluzioni più comuni, consulta le nostre guide alla risoluzione dei problemi per
Android e
web. Se hai altre domande, contatta
l'assistenza tramite Google Pay & Wallet Console.
Come posso personalizzare la mia integrazione dell'API Google Pay per limitare le carte?
Tutte le personalizzazioni per le carte sono disponibili nell'oggetto CardParameters sia per
Android sia per
web. Ad esempio, puoi scegliere quali circuiti di carte e quali paesi degli emittenti delle carte vuoi consentire.
Che cos'è l'API Google Pay?
L'API Google Pay consente ai tuoi clienti di pagare con un semplice clic utilizzando i metodi di pagamento salvati nel loro Account Google. L'API offre un pagamento semplice a milioni di utenti con centinaia di milioni di carte salvate. Offre una maggiore sicurezza, con i dati di pagamento dei clienti criptati end-to-end dai server di Google all'elaboratore dei pagamenti. È un processo di integrazione semplice che funziona con
il tuo stack di elaborazione dei pagamenti esistente e può essere implementato con poche righe di codice.
Qual è il rapporto tra l'API Google Pay e l'API Google Wallet?
L'API Google Pay e l'API Google Wallet sono due API distinte. L'API Google Pay consente ai tuoi
clienti di utilizzare Google Pay come metodo di pagamento sul tuo sito web o nella tua app per Android.
L'API Google Wallet consente agli sviluppatori di creare e gestire tessere digitali per una serie di casi
d'uso. Ad esempio, carte fedeltà, biglietti, tessere di accesso, riepiloghi salute e altri elementi personalizzabili. Per saperne di più sull'API Google Wallet, visita la
documentazione per lo sviluppo dell'API Google Wallet.
Qual è la versione attuale dell'API Google Pay e come vengono gestiti gli aggiornamenti?
La versione corrente è elencata nella documentazione per Android e per il web. Google ha mantenuto questa
versione per diversi anni, aggiungendo solo nuove funzionalità e campi facoltativi. Tutti gli aggiornamenti apportati all'API sono compatibili con le versioni precedenti per garantire che le integrazioni attuali non vengano interrotte.
Quali piattaforme supportano i DPAN (CRYPTOGRAM_3DS) rispetto agli FPAN (PAN_ONLY)?
I DPAN sono specifici di Android e sono disponibili solo quando si effettua il pagamento su dispositivi Android o su web mobile/WebView Android. I dispositivi web desktop e iOS non supportano i DPAN e restituiranno PAN_ONLY per impostazione predefinita.
Come facciamo a distinguere un DPAN da un FPAN e come devono essere gestiti?
Anziché identificare rigorosamente i DPAN rispetto agli FPAN, l'oggetto assuranceDetails è progettato per aiutare i commercianti a determinare se una transazione deve essere sottoposta a un'autenticazione aggiuntiva tramite 3D Secure per soddisfare i requisiti di autenticazione forte del cliente (SCA). Per ricevere questi dettagli, i commercianti devono aggiungere
assuranceDetailsRequired: true al parametro Card nella richiesta dell'API Google Pay.
Qual è la differenza tra cardHolderAuthenticated e accountVerified?
Quando assuranceDetailsRequired è impostato su true nella richiesta, la risposta includerà due proprietà:
accountVerified: indica che la carta utilizzata per il pagamento è autentica e l'account è in regola. Tuttavia, questa verifica da sola non fornisce la protezione dell'autorizzazione.
cardHolderAuthenticated: indica che l'utente ha avviato la transazione con il proprio dispositivo Android e ha utilizzato un token di rete basato sul dispositivo di cui è stato eseguito il provisioning.
Come utilizziamo questi flag per attivare 3D Secure?
I commercianti devono utilizzare questi flag per creare la logica di attivazione di 3D Secure. Se sia cardHolderAuthenticated che accountVerified restituiscono true, le credenziali sono considerate altamente sicure e conformi alla SCA e non è necessario eseguire lo step up della transazione per un'ulteriore autenticazione 3DS.
I commercianti riceveranno i token di e-commerce se impostano assuranceDetailsRequired: true?
No, i token di e-commerce sono controllati a livello di PSP.
Le transazioni Google Pay sono idonee al trasferimento di responsabilità?
Come possiamo identificare le transazioni Buy now, pay later (BNPL)?
Al momento non esiste un identificatore specifico per le transazioni BNPL. Verranno visualizzate nel tuo sistema
come normali credenziali FPAN.
Google può fornire carte di prova per testare gli scenari SCA?
L'API Google Pay non può fornire direttamente carte di test SCA. Il tuo PSP dovrebbe essere in grado di utilizzare la propria suite di carte di test all'interno del suo ambiente sandbox per le tue esigenze di test.
Qual è la scadenza o la durata (TTL) della credenziale di pagamento criptata?
Il payload di Google Pay criptato scade esattamente dopo una settimana. I commercianti che gestiscono autorizzazioni ritardate o elaborazioni asincrone devono assicurarsi che il pagamento venga autorizzato dal proprio fornitore di servizi di pagamento (PSP) entro questo periodo di tempo prima della scadenza del payload.
Come vengono gestite le operazioni post-acquisto, come rimborsi e riautorizzazioni?
Google Pay non è coinvolto nel flusso di denaro e funge esclusivamente da intermediario per la credenziale tokenizzata. Una volta eseguita la transazione iniziale, il tuo fornitore di servizi di pagamento (PSP) mappa i dati di pagamento nel payload criptato con il proprio token proprietario (ad esempio un "token commerciante" o un "ID profilo cliente"). Tutte le interazioni post-acquisto e i movimenti di denaro vengono gestiti
interamente tra te e il tuo PSP.
Come funzionano i prezzi dinamici con le transazioni avviate dal commerciante?
Al momento, le transazioni avviate dal commerciante (MIT) non supportano i prezzi dinamici. Si tratta di una limitazione nota.
Quale configurazione della Content Security Policy (CSP) è richiesta per Google Pay in una WebView?
Se utilizzi un criterio di sicurezza del contenuto (CSP), assicurati di impostare i valori corretti per l'istruzione connect-src per consentire l'utilizzo di Google Pay in WebView. Ad esempio:
Google Pay applica questo attributo nonce a tutti gli elementi <style> e <script> inseriti dinamicamente, inclusi gli stili dei pulsanti creati da createButton().
L'API Google Pay utilizza o richiede il cookie NID durante il pagamento?
No. Il cookie NID non viene utilizzato per il flusso di checkout dell'API Google Pay e non lo supporta.
Il cookie NID è associato a un servizio lato server di Google progettato per memorizzare dati personalizzati per gli utenti che non hanno eseguito l'accesso a un Account Google.
Le funzioni essenziali del servizio, tra cui la sicurezza, la prevenzione delle frodi e l'affidabilità del servizio, operano indipendentemente dal cookie NID. L'API Google Pay è progettata per mantenere
un'esperienza sicura e affidabile per commercianti e utenti indipendentemente dalla presenza di questo
cookie.
Google si impegna a tutelare la privacy e garantisce che questi cookie vengano gestiti in conformità alle
Norme sulla privacy e alle
Norme relative a tecnologie e cookie di Google.
Queste risorse potrebbero esserti utili per la documentazione di conformità e per fornire ulteriore trasparenza ai tuoi utenti.
[[["Facile da capire","easyToUnderstand","thumb-up"],["Il problema è stato risolto","solvedMyProblem","thumb-up"],["Altra","otherUp","thumb-up"]],[["Mancano le informazioni di cui ho bisogno","missingTheInformationINeed","thumb-down"],["Troppo complicato/troppi passaggi","tooComplicatedTooManySteps","thumb-down"],["Obsoleti","outOfDate","thumb-down"],["Problema di traduzione","translationIssue","thumb-down"],["Problema relativo a esempi/codice","samplesCodeIssue","thumb-down"],["Altra","otherDown","thumb-down"]],["Ultimo aggiornamento 2026-10-15 UTC."],[],["The Google Pay API allows customers to use saved cards for checkout in apps and websites. Merchants can manage recurring billing and auto-reloads by storing payment credentials and using payment gateway APIs. Nonprofits can collect donations with proper documentation. The API supports tokenized and PAN cards, with specific handling for 3D Secure. Gambling, healthcare, and financial service integrations require specific licenses and adherence to policies. Google does not charge additional fees but Merchants are still responsible for fraud, risk assessments and payment processor fees.\n"]]