Risoluzione dei problemi

La guida alla risoluzione dei problemi di Android tratta problemi e domande relativi ai seguenti argomenti.

L'app è attualmente in esecuzione in un ambiente di test

Quando l'utente sceglie una carta di pagamento dalla finestra di dialogo dei dettagli di pagamento, potrebbe visualizzare il seguente messaggio:

L'app è attualmente in esecuzione in un ambiente di test: le transazioni non comportano un addebito effettivo

Questo errore indica che l'app utilizza ENVIRONMENT_TEST e non riceve credenziali di pagamento reali, ma riceve dati personali che includono indirizzo di fatturazione, numero di telefono dell'indirizzo di fatturazione, indirizzo di spedizione e indirizzo email, se richiesti.

Richiesta non riuscita

Il messaggio di errore più comune è OR_BIBED_06. Questo messaggio di errore viene visualizzato anche nella UI come finestra di dialogo con il seguente testo:

Richiesta non riuscita
Si è verificato un problema con l'integrazione di Google Pay del commerciante. Contatta il commerciante per ricevere assistenza o paga con un altro metodo.

Per saperne di più su questo errore, segui questi passaggi:

  1. Assicurati che Android Debug Bridge (adb) sia installato sul computer.
  2. Assicurati che il debug USB sia attivato sul dispositivo. Per ulteriori informazioni, vedi Eseguire il debug dell'app.
  3. Collega il dispositivo Android al computer o avvia il simulatore.

  4. Esegui questo comando in un terminale o in un prompt dei comandi sul computer:

    adb logcat -s WalletMerchantError

La risposta indica il motivo dell'errore. Ad esempio, potresti visualizzare:

02-26 17:41:28.133 14593 14593 W WalletMerchantError: Error in loadPaymentData: This
merchant profile does not have access to this feature.

L'azione che devi intraprendere per risolvere il problema dipende dal messaggio di errore.

Validità del gateway

A un certo punto dell'integrazione, potresti riscontrare i seguenti errori relativi alla validità del gateway. L'elenco seguente fornisce alcuni suggerimenti utili per la risoluzione dei problemi in caso di errori.

OR_BIBED_06 Gateway sconosciuto 'yourgateway'
Il valore della proprietà gateway che hai specificato in tokenizationSpecification non è attualmente supportato dall'API Google Pay. Contatta il tuo gateway per ulteriori informazioni sul suo identificatore e sui campi associati, come gatewayMerchantId.
OR_BIBED_06 Il gateway "example" non può essere utilizzato in modalità di produzione.
Il valore della proprietà gateway di esempio viene utilizzato solo a scopo di test e non può essere utilizzato con un valore del parametro dell'ambiente WalletOptions impostato su WalletConstants.ENVIRONMENT_PRODUCTION. Contatta il tuo gateway per saperne di più sui parametri gateway che devi utilizzare con l'API Google Pay.

Registrazione e accesso

A un certo punto dell'integrazione, potresti riscontrare i seguenti errori relativi alla registrazione e all'accesso. L'elenco seguente fornisce alcuni suggerimenti utili per la risoluzione dei problemi in caso di errori.

OR_BIBED_07 Questa API richiede la versione 8.4 o successive della libreria Google Play Services
Assicurati che Google Play Services sia aggiornato sul dispositivo che esegue l'app.
OR_BIBED_07 Nessuna chiave trovata per questo profilo commerciante
Per completare un'integrazione DIRECT tokenizationSpecification type, devi registrare la tua chiave di crittografia pubblica presso Google utilizzando la console Google Pay & Wallet.
OR_BIBED_07 Questo profilo del commerciante non ha accesso a questa funzionalità.
Non hai completato la procedura per registrare la tua app per l'API Google Pay. Per saperne di più, consulta Richiedere l'accesso in produzione.
OR_BIBED_10 Questo commerciante si trova in una regione in cui Google Pay non è accettato.
Il servizio Google Pay non è disponibile nella regione. Per saperne di più, consulta l' elenco dei paesi supportati.
OR_BIBED_11 Questo commerciante non ha completato la registrazione per utilizzare l'API Google Pay. Per la verifica, vai alla console (https://pay.google.com/business/console).
Non hai completato la procedura per registrare la tua app per l'API Google Pay. Per saperne di più, consulta Richiedere l'accesso in produzione.
OR_BIBED_12 Questa integrazione dell'API Google Pay è disabilitata. Contattaci per ulteriori informazioni (https://developers.google.com/pay/api/faq#how-to-get-support).
Contattaci per scoprire di più sui passaggi necessari per riattivare l'API Google Pay per il tuo account.
Le OR_BIBED_13impronte della chiave di firma{11:22:33:44:55:66:77:88:99:AA:BB:CC:DD:EE:FF:11:22:33:44:55} non corrispondono ai nostri dati per questa app.
L'API Google Pay può essere utilizzata in modalità di produzione solo se l'APK è firmato con la chiave di firma corretta. Per ulteriori informazioni, vedi Firma dell'app.

Commercianti diretti

A un certo punto dell'integrazione, potresti riscontrare i seguenti errori relativi al commerciante diretto. L'elenco seguente fornisce alcuni suggerimenti utili per la risoluzione dei problemi in caso di errori.

Verifica della firma
Potresti riscontrare un errore di verifica della firma se il merchantId non è corretto. Ciò può accadere nell'ambiente TEST quando utilizzi la libreria Tink paymentmethodtoken. Per evitare questo problema, imposta YOUR_MERCHANT_ID su in:
.recipientId("merchant:YOUR_MERCHANT_ID")
Impossibile decriptare il token
Se utilizzi la libreria Tink paymentmethodtoken per decriptare un token, tieni presente quanto segue:
  • Assicurati che l'ambiente di risposta dell'API Google Pay corrisponda all'ambiente Tink. Ad esempio, se la risposta dell'API Google Pay è stata restituita da ENVIRONMENT_TEST, Tink rimanda all'ambiente di test per la decriptografia.
  • Non modificare la risposta dell'API Google Pay prima che venga trasmessa a Tink. Assicurati di trasmettere l'intero token restituito dalla risposta dell'API Google Pay. Per ulteriori dettagli, consulta la nota seguente:
  • Verifica di disporre della chiave privata corretta associata alla chiave pubblica che hai registrato su Google.
Generare una coppia di chiavi pubblica e privata su Windows
Se utilizzi Windows e vuoi seguire i passaggi descritti in Utilizzare OpenSSL per generare una coppia di chiavi privata e pubblica, assicurati di installare Cygwin sul tuo computer. Questo è necessario per eseguire i comandi Linux.

Android WebView

OR_BIBED_15 Google Pay non è riuscito a caricarsi correttamente perché questa app utilizza una WebView. Gli sviluppatori di app devono seguire specifiche istruzioni per consentire a Google Pay di funzionare all'interno di Android WebView.
Segui le istruzioni per abilitare l'API Google Pay per Android WebView.

CardInfo

Che cos'è la funzionalità CardInfo?
Google Pay indica ai consumatori che dietro il pulsante di pagamento Google Pay c'è una carta, che mostra sia la rete del brand della carta sia le ultime quattro cifre della carta.
Perché la funzionalità CardInfo non viene visualizzata nella mia implementazione?

Per far funzionare la funzionalità CardInfo, sono necessarie le seguenti condizioni: