Domande frequenti

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 pagamenti senza problemi nelle tue app e sui tuoi siti.

Come ricevere assistenza

Registrati alla console di Google Pay e Wallet e seleziona Contatta l'assistenza. Possiamo aiutarti a risolvere i problemi relativi alle integrazioni. Inoltre, consulta la nostra guida alla risoluzione dei problemi di Android e la guida alla risoluzione dei problemi del web per eseguire il debug autonomo dell'integrazione.

Funzionalità supportate

L'API Google Pay supporta diverse funzionalità.

Forme di pagamento supportate

L'API Google Pay può restituire carte o token di rete.

Fatturazione ricorrente e abbonamenti

Il supporto della fatturazione ricorrente è legato al metodo di pagamento restituito nella risposta dell'API Google Pay. Per la fatturazione ricorrente possono essere utilizzate sia le carte tokenizzate sia le carte memorizzate. Per elaborare la fatturazione ricorrente, il commerciante non deve chiamare la nostra API a una determinata cadenza. ma le credenziali di pagamento vengono memorizzate dal 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 della rete, ad esempio le transazioni avviate dal commerciante.
I termini di pagamento vengono comunicati e accettati dall'utente nel flusso di acquisto del commerciante.

Supportiamo anche la fatturazione ricorrente con importi variabili. Ad esempio, sono supportate le bollette telefoniche mensili per gli operatori di telefonia mobile. Per saperne di più, i commercianti devono contattare il rappresentante del gateway di pagamento.

Ricarica automatica

Per elaborare un addebito di ricarica automatica allo 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 cancellazioni, 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 stato di non profit. Ad esempio, le non profit statunitensi devono fornire una prova valida dello stato 501(c)3 dell'IRS per qualificarsi.

Termini e norme

Termini di servizio dell'API Google Pay

Tutti i commercianti devono accettare e rispettare i Termini di servizio dell'API Google Pay.

Norme di utilizzo accettabile dell'API Google Pay

Tutti i commercianti devono accettare e rispettare le norme di utilizzo accettabile dell'API Google Pay.

Norme relative a giochi e scommesse

Le nostre norme sul gioco d'azzardo sono definite nelle Norme di utilizzo accettabile dell'API Google Pay.

Le nostre norme sul gioco e le scommesse possono cambiare di tanto in tanto. Tutti i contenuti inviati sono soggetti a revisione e approvazione.

Accettiamo integrazioni di giochi e scommesse da società con sede nei seguenti paesi:

Australia
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 scegliere di estendere il supporto oltre il livello attuale.

Per ottenere l'accesso in produzione all'API Google Pay per le integrazioni di giochi e scommesse, devi completare 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. A questo punto, possiamo 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 web con sede in uno dei paesi menzionati in precedenza, 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 l'integrazione solo web per l'accesso alla 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 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: Sono idonee le app che reindirizzano a un sito web. 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 di cani sono vietate. Le scommesse sul differenziale sono vietate. Sono vietate le piattaforme di scambio di scommesse.	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 di cani sono vietate. Le scommesse sul differenziale sono vietate. Sono vietate le piattaforme di scambio di scommesse.
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: Sono idonei i fornitori di servizi di giochi e scommesse con licenza.
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 il quale non avevi ricevuto l'approvazione, 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 è consentito l'utilizzo dell'API Google Pay per servizi di gioco e scommesse rivolti a persone minorenni o altrimenti vietati dal gioco e dalle scommesse ai sensi delle leggi locali.

Norme sanitarie

Le nostre norme relative all'assistenza sanitaria sono definite nelle Norme di utilizzo accettabile dell'API Google Pay.

Quando esegui l'onboarding, preparati a condividere una licenza pertinente per convalidare il tuo caso d'uso sanitario. Tutti i contenuti inviati sono soggetti a revisione e approvazione.

Norme relative ai servizi finanziari

Le nostre norme sui servizi finanziari sono definite nelle Norme di utilizzo accettabile dell'API Google Pay.

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 importante per gestire tutti i rischi e l'autenticazione avanzata del cliente. Cosa devo sapere di 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 criptogrammi.

I payload delle carte tokenizzate vengono elaborati senza ulteriori passaggi di verifica o sfide.

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 nella pagina di pagamento.
transactionInfo.countryCode (Android, web): indica dove viene elaborata la transazione. Devi specificare il paese della banca emittente.
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 approva il tuo sito web. Per avviare la procedura, accedi alla console Google Pay & Wallet 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 sui loro siti per i loro utenti?

Per evidenziare il supporto di Google Pay, assicurati di utilizzare gli asset disponibili nelle nostre linee guida per il branding Android e web.

Se hai un'integrazione Android, puoi indicare nella descrizione del Play Store che ora supporti Google Pay. Per le integrazioni web, puoi aggiungere direttamente una descrizione al sito web del commerciante.

Le piattaforme di e-commerce possono supportare Google Pay?

Sì, l'API Google Pay supporta l'integrazione delle piattaforme di e-commerce. I partner di elaborazione dei pagamenti, gateway o piattaforme di e-commerce che ospitano una pagina di pagamento per conto dei propri commercianti possono utilizzare la funzionalità di pagamento ospitato di Google Pay.

Quali fornitori di servizi di pagamento supportano Google Pay?

Per trovare un elenco dei processori che supportano Google Pay, consulta l'elenco dei processori di 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)?

Consulta la nostra pagina Trovare i metodi di pagamento supportati per gli acquisti contactless e in negozio per un elenco dei paesi e delle banche di ciascun paese che supportano i token Google Pay (CRYPTOGRAM_3DS). Sono elencate sia le carte supportate sia quelle non supportate.

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 giochi virtuali, funzionalità o contenuti di app e prodotti software cloud. Per scoprire di più sulla fatturazione in-app, consulta la pagina Panoramica della 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 commissioni aggiuntive 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 sicurezza (CVC). Google esegue anche un motore di rischio proprietario basato su dati degli strumenti, profili dell'Account Google, cronologia degli acquisti, posizioni e informazioni sul dispositivo. I commercianti, tuttavia, devono continuare a utilizzare i loro attuali strumenti di valutazione di frodi e rischi con le transazioni Google Pay.

Google Pay è supportato nelle WebView delle app mobile?

Le WebView di Android supportano completamente Google Pay e imitano 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 alla produzione. Per dettagli specifici sull'implementazione, consulta la documentazione relativa a Utilizzo di Android WebView o Utilizzo di iOS WKWebView.

Il mio processore non è presente nell'elenco. Posso ancora eseguire l'integrazione con Google Pay?

Google Pay continua a stringere partnership con piattaforme di e-commerce e processori di pagamento. Se non riesci a trovare il tuo elaboratore all'indirizzo g.co/pay/processors, puoi inviare una richiesta. Riceverai una notifica quando il tuo processore sarà disponibile.

Come faccio ad attivare Google Pay se ho già un elaboratore dei pagamenti o un fornitore di piattaforma di pagamento?

Google Pay funziona con una serie di fornitori di servizi di pagamento e fornitori di piattaforme di e-commerce. Ognuno offre una documentazione specifica e personalizzata per aiutarti a iniziare, oltre al nostro tutorial principale per un facile onboarding.

Come faccio a offrire Google Pay su larga scala ai miei commercianti se sono un elaboratore di pagamenti di assistenza?

I processori di pagamento supportati possono implementare la nostra soluzione di checkout ospitato 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 ospitato, contatta il tuo punto di contatto tecnico di Google che ti ha aiutato con l'onboarding.

Se offro la spedizione nel mio flusso di pagamento, in che modo Google Pay può gestire diverse opzioni di spedizione e prezzi diversi per i miei utenti?

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 una situazione di esempio, 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 il denaro 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 integrarsi con l'infrastruttura di pagamento esistente.

Quali sono i requisiti per ottenere l'accesso alla 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 per l'approvazione singolarmente, in quanto i domini 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 conoscere 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 la tua integrazione rispetta le nostre Norme di utilizzo accettabile e le linee guida per il brand, viene approvata e lo stato visualizzato in Google Pay & Wallet Console è Attivo. Se sono necessarie modifiche, lo stato è 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 sul tuo 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 codici di errore e soluzioni 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 l'integrazione dell'API Google Pay per limitare le carte?

Tutte le personalizzazioni delle schede sono disponibili nell'oggetto CardParameters sia per Android sia per web. Ad esempio, puoi scegliere quali circuiti di carte e quali paesi emittenti di carte vuoi consentire.

Che cos'è l'API Google Pay?

L'API Google Pay consente ai tuoi clienti di pagare con la pressione di un pulsante con i metodi di pagamento salvati nel loro Account Google. L'API fornisce un semplice pagamento a milioni di utenti con centinaia di milioni di carte salvate. Offre una maggiore sicurezza, con i dati di pagamento dei clienti crittografati end-to-end dai server di Google fino 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 separate. 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, cartelle cliniche e altri elementi personalizzabili. Per saperne di più sull'API Google Wallet, consulta la documentazione per sviluppatori dell'API Google Wallet.

Qual è la versione attuale dell'API Google Pay e come vengono gestiti gli aggiornamenti?

La versione attuale è elencata nella documentazione Android e 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 ai FPAN (PAN_ONLY)?

I DPAN sono specifici per Android e sono disponibili solo al momento del pagamento su dispositivi Android o su web mobile/WebView Android. Il web da computer e i dispositivi iOS non supportano i DPAN e per impostazione predefinita restituiscono PAN_ONLY.

Come facciamo a distinguere un DPAN da un FPAN e come devono essere gestiti?

Anziché identificare rigorosamente i DPAN rispetto ai FPAN, l'oggetto assuranceDetails è progettato per aiutare i commercianti a determinare se una transazione deve essere sottoposta a 3D Secure per soddisfare i requisiti di autenticazione forte del cliente (SCA). Per ricevere questi dettagli, i commercianti devono aggiungere assuranceDetailsRequired: true al parametro della carta 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 che l'account è in regola. Tuttavia, questa verifica da sola non fornisce la protezione dell'autorizzazione.
cardHolderAuthenticated: indica che l'utente ha iniziato 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 aumentare la transazione per un'ulteriore autenticazione 3DS.

I commercianti riceveranno token e-commerce se impostano assuranceDetailsRequired: true?

No, i token e-commerce sono controllati a livello di PSP.

Le transazioni Google Pay sono idonee al trasferimento di responsabilità?

La disponibilità del trasferimento di responsabilità dipende dal circuito della carta. MasterCard lo fornisce automaticamente per le transazioni con token qualificate, mentre Visa richiede ai commercianti di attivarlo manualmente tramite la console Google Pay. Per maggiori dettagli, consulta Attivare il trasferimento di responsabilità Visa.

Come possiamo identificare le transazioni Acquista ora, paga dopo (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 test 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 suite di carte di test all'interno del proprio ambiente sandbox per le tue esigenze di test.

Qual è la scadenza o la durata (TTL) della credenziale di pagamento criptata?

Il payload Google Pay criptato scade esattamente dopo una settimana. I commercianti che gestiscono autorizzazioni ritardate o elaborazione asincrona devono assicurarsi che il pagamento sia autorizzato con il 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 le credenziali tokenizzate. 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 e i movimenti di denaro successivi all'acquisto vengono gestiti interamente tra te e il tuo PSP.