Riferimento cliente

Questo riferimento descrive i metodi client JavaScript da utilizzare per implementare l'API Google Pay nelle tue applicazioni web.

Costruttore

Inizializza l'oggetto PaymentsClient. Devi chiamare questo costruttore prima di chiamare i metodi dei membri.

new PaymentsClient(paymentOptions)

Argomenti

Proprietà Descrizione
paymentOptions

Un oggetto contenente coppie chiave-valore dei dati di configurazione dell'API Google Pay. Consulta PaymentOptions per le diverse proprietà configurabili.

Esempio: {environment:'PRODUCTION'}

Resi

Tipo Descrizione
google.payments.api.PaymentsClient L'oggetto PaymentsClient.

Genera

Tipo Descrizione
Error

Il valore della proprietà dell'ambiente passato non è supportato.

Metodi degli oggetti

createButton(options)

Il metodo di convenienza viene utilizzato per generare un pulsante di pagamento Google Pay con lo stile del branding Google Pay più recente da inserire in una pagina web.

Il codice HTMLElement generato include CSS inserito dinamicamente e un'immagine SVG ospitata sulla CDN di Google.

Consulta le nostre linee guida per il brand per saperne di più su come selezionare il colore e il tipo di pulsante appropriati per il design del tuo sito. Potresti dover modificare le dimensioni del pulsante per adattarle a pulsanti simili o elementi di pagamento della tua pagina. Utilizza il nostro strumento Personalizza il pulsante per configurare un pulsante per il tuo caso d'uso.

Argomenti

Nome Descrizione
options

Un oggetto che contiene coppie chiave-valore per la configurazione di un pulsante. Consulta ButtonOptions per le proprietà configurabili.

Esempio: {onClick:onGooglePaymentButtonClicked}

Resi

Tipo Descrizione
HTMLElement Un elemento HTML <button> all'interno di un contenitore di contenuti di flusso generico, come <div>.

Genera

Tipo Descrizione
Error

Una proprietà obbligatoria non è impostata.

isReadyToPay(isReadyToPayRequest)

Utilizza il metodo isReadyToPay(isReadyToPayRequest) per determinare la capacità di un utente di restituire una forma di pagamento dall'API Google Pay.

Se il browser supporta Google Pay, isReadyToPay restituisce true. Per determinare se l'utente ha eseguito l'accesso a un Account Google o ha già salvato un metodo di pagamento in Google Pay, imposta IsReadyToPayRequest.existingPaymentMethodRequired su true e verifica che paymentMethodPresent restituisca true nella promessa risolta. Per maggiori dettagli, consulta IsReadyToPayResponse.

Se PaymentsClient è inizializzato con una proprietà di ambiente di TEST, paymentMethodPresent restituisce sempre true.

Argomenti

Nome Descrizione
isReadyToPayRequest Un oggetto che contiene i metodi di pagamento supportati dal commerciante. Per maggiori dettagli sulle diverse proprietà configurabili, consulta IsReadyToPayRequest.

Resi

Tipo Descrizione
Promise

Resolved: un oggetto che contiene informazioni sulla capacità di pagamento dell'utente. Per saperne di più, consulta IsReadyToPayResponse.

Rejected: un oggetto di errore che contiene ulteriori informazioni sul motivo del rifiuto. Per ulteriori informazioni, vedi PaymentsError.

Errori

statusCode Descrizione
DEVELOPER_ERROR
  • L'oggetto IsReadyToPayRequest passato non è stato formattato correttamente, non contiene i parametri minimi richiesti per determinare l'idoneità di un utente a pagare o contiene un parametro e/o un valore non validi.
  • La richiesta è stata avviata da un contesto di sicurezza che l'agente di pagamento o il browser ha scelto di non soddisfare. In genere, si tratta di un errore di contesto del browser non sicuro.

loadPaymentData(paymentDataRequest)

Questo metodo presenta un foglio di pagamento Google Pay che consente di selezionare un metodo di pagamento e i parametri configurati facoltativamente.

Questo metodo deve essere chiamato mentre il browser elabora un comportamento di attivazione come risultato di un evento di clic. All'utente potrebbe essere mostrata una finestra popup per selezionare un metodo di pagamento o altri dati richiesti specificati nel parametro della richiesta trasmesso.

Argomenti

Nome Descrizione
paymentDataRequest Un oggetto che contiene coppie chiave-valore della configurazione completa dell'API Google Pay. Consulta PaymentDataRequest per le proprietà configurabili.

Resi

Tipo Descrizione
Promise

Risolta: un oggetto che contiene i dati dell'acquirente richiesti. Per saperne di più, consulta PaymentData.

Rejected: un oggetto contenente un codice di errore e ulteriori informazioni sul motivo del rifiuto. Per saperne di più, consulta PaymentsError.

Errori

statusCode Descrizione
CANCELED
  • Il browser corrente o l'utente Google che ha eseguito l'accesso non sono supportati.
  • L'acquirente ha chiuso il foglio di pagamento di Google Pay senza autorizzazione di pagamento.
  • La richiesta è stata avviata da un contesto di sicurezza che l'agente di pagamento o il browser ha scelto di non soddisfare. In genere si tratta di un contesto del browser non sicuro.
  • Il metodo è stato chiamato mentre il foglio di pagamento di Google Pay era già visualizzato.
  • L'oggetto PaymentDataRequest passato è stato rifiutato dal foglio di pagamento di Google Pay. Una causa comune è la mancanza o l'incompletezza dei parametri PaymentMethodTokenizationSpecification per il tuo gateway o valori dei parametri non validi.
DEVELOPER_ERROR L'oggetto PaymentDataRequest passato non è stato formattato correttamente, non contiene i parametri minimi richiesti o contiene un parametro e/o un valore non valido.

prefetchPaymentData(paymentDataRequest)

Utilizza questo metodo per eseguire il precaricamento di una configurazione PaymentDataRequest per migliorare il tempo di esecuzione di loadPaymentData in caso di interazione successiva dell'utente. Non viene restituito alcun valore.

Le ottimizzazioni di precaricamento sono disponibili su Chrome per Android.

Argomenti

Nome Descrizione
paymentDataRequest Un oggetto che contiene coppie chiave-valore della configurazione completa dell'API Google Pay. Consulta PaymentDataRequest per le proprietà configurabili. Una modifica alla proprietà transactionInfo non influisce sul valore di precaricamento memorizzato nella cache.

Callback dei dati di pagamento

I seguenti gestori callback possono essere passati a PaymentOptions.paymentDataCallbacks per supportare l'autorizzazione dei pagamenti e gli aggiornamenti dei prezzi dinamici.

onPaymentAuthorized(paymentData)

Questo metodo viene chiamato quando un pagamento viene autorizzato nel foglio di pagamento.

Argomenti

Nome Descrizione
paymentData Un oggetto che contiene i dati dell'acquirente richiesti. Per maggiori dettagli, vedi PaymentData.

Resi

Tipo Descrizione
Promise

Resolved: un oggetto che contiene informazioni sui risultati delle transazioni di pagamento. Per maggiori dettagli, vedi PaymentAuthorizationResult.

Rifiutata: un oggetto di errore con un intent di errore e un messaggio da visualizzare nel foglio di pagamento. Per maggiori dettagli, vedi PaymentDataError.

onPaymentDataChanged(intermediatePaymentData)

Questo metodo gestisce le modifiche ai dati di pagamento nel foglio di pagamento, ad esempio l'indirizzo di spedizione e le opzioni di spedizione.

Argomenti

ciao
Nome Descrizione
intermediatePaymentData Un oggetto che contiene l'indirizzo e l'opzione di spedizione selezionati nel foglio di pagamento. Per maggiori dettagli, vedi IntermediatePaymentData.

Resi

Tipo Descrizione
Promise

Risolto: un oggetto che contiene informazioni sui nuovi dati della transazione, sulle opzioni di spedizione e sugli errori dei dati di pagamento. Per maggiori dettagli, vedi PaymentDataRequestUpdate.

Rifiutata: un oggetto di errore con un intent di errore e un messaggio da visualizzare nel foglio di pagamento. Per maggiori dettagli, vedi PaymentDataError.