La funzione di registrazione delle carte regalo (accesso) consente agli utenti di cercare un carta regalo e aggiungerla a Google Wallet. Gli utenti verranno indirizzati al tuo sito web ottimizzato per il mobile per completare la , dopodiché potrà aggiungere la carta a Google Wallet.
Questa guida fornisce una panoramica dei passaggi di implementazione richiesti per attivare il programma delle carte regalo per questa funzionalità.
Panoramica
Per iniziare, assicurati di aver già configurato il tuo progetto e di avere accesso API Google Wallet.
Devi seguire questi quattro passaggi per implementare la funzionalità di accesso per il tuo programma di carte regalo:
- Configura una classe di prova in Google Wallet per testare il flusso di accesso.
- Sviluppa pagine di accesso che utilizzino Google Wallet
SharedDataType. - Implementa il respingimento della carta regalo su Google Wallet dopo l'accesso.
- Richiedi la verifica e l'attivazione.
Impostare un corso di prova in Google Wallet
Determina l'URL di accesso, ovvero il logo del programma. Poi,
utilizza i campi nidificati discoverableProgram nella
giftcardclass per impostare
i valori appropriati.
Imposta i valori in discoverableProgram per creare una versione bozza del tuo
programma di carte regalo abilitato per l'accesso. Per assicurarti che sia visibile ai tester, verifica che
I tester hanno accesso a Google Pay e alla tua console Wallet. Per i dettagli su come condividere
Accesso a Google Pay e alla console Wallet con altre persone; consulta
Scopri di più sulla pagina Utenti.
Completare la verifica della funzionalità dell'implementazione durante lo sviluppo contattaci utilizzando il widget Contatta l'assistenza in Google Pay e Wallet Console. Mentre sei Nella console, seleziona API Google Wallet nell'argomento e poi Accesso con carta regalo l'argomento secondario.
Sviluppare una pagina di accesso che utilizzi i dati utente di Google Wallet
Quando un utente sceglie di aggiungere la tua carta regalo, vengono indirizzati a una pagina personalizzata sul tuo sito web per completare durante la procedura di accesso.
Devi fornire un URL di accesso da cui un utente può accedere a un account esistente.
La pagina di accesso deve soddisfare i seguenti requisiti:
- Offri un'esperienza utente ottimizzata per i dispositivi mobili.
- Consenti all'utente di completare l'accesso in una singola pagina.
- Usa la crittografia di
HTTPScon un certificato valido per assicurarti che i dati utente vengano trasmessi in modo sicuro. - Assicurati di avere un tempo di attività pari ad almeno il 99,9% della tua pagina di accesso.
Quando presenti la pagina di accesso, Google Wallet crea
viene fatta una richiesta Android WebView e POST all'indirizzo fornito
URL. I dati utente vengono forniti nel parametro SharedDataType
incluso nella richiesta POST utilizzando
il tipo di contenuti application/x-www-form-urlEncoding e
UTF-8. Il valore dell'attributo SharedDataType
è un oggetto JSON codificato in Base64.
Implementa il respingimento immediato della carta regalo su Google Wallet
Una volta autenticata (accesso), la tua pagina deve respingere immediatamente la carta regalo dell'utente a Google Wallet.
Puoi respingere la carta regalo a Google Wallet reindirizzando a un che segue la struttura
https://pay.google.com/gp/v/save/{jwt_generated}
La lunghezza di sicurezza di un URL è di 2000 caratteri. I link devono rimangono al di sotto di questo limite. Gli oggetti codificati in JWT devono essere di piccole dimensioni e contenere solo specifici dell'utente. Cerca di conservare la maggior parte dei dati nella classe dell'oggetto, prima di creare il JWT. Per gli oggetti più grandi che non rientrano nel limite, considera a creare prima l'oggetto API Google Wallet e inviando solo l'ID oggetto nel JWT.
Flusso di comunicazione tipico
Il flusso di comunicazione per un utente che completa l'accesso è illustrato nel nell'immagine che segue. Tutte le azioni tra "Il tuo server" la cui implementazione è di tua responsabilità.
Richiedi verifica e attivazione
Dopo aver completato il lavoro di sviluppo e testato il flusso di accesso, invia una richiesta tramite Google Pay e Console Wallet contatta l'assistenza widget.
Dopo una revisione completa dell'implementazione che ha confermato la funzionalità corretta in in combinazione con l'app Google Wallet, la funzione di accesso alle carte regalo verrà lanciato pubblicamente per il programma relativo alle carte regalo. In questo modo qualsiasi utente potrà visualizzare programma e utilizzare questa funzione.
Per garantire un'esperienza utente ottimale, controlli ricorrenti di accesso per garantire la conformità continua ai requisiti delle funzionalità. In caso di discrepanze, riceverai una notifica e la funzione di accesso potrebbe essere disattivato finché il problema non verrà risolto.
Domande frequenti
- Esistono requisiti per le immagini utilizzate nel programma delle carte regalo?
- Sì, le immagini devono essere ospitate in
HTTPSposizione in quanto non saranno visibili in Google Wallet.
- Sì, le immagini devono essere ospitate in
- Esistono strumenti che semplificano l'implementazione e il debug dei JWT?
- Sì, piattaforme come www.jwt.io ti consente di decodificare ed eseguire il debug dei token durante il processo di sviluppo, consentendoti di verificare contenuti che stai inviando. Tieni presente che Google non ha alcuna affiliazione e non consigliano espressamente queste terze parti.
- Come gestiamo correttamente i dati SharedDataType codificati in Base64?
- Assicurati di utilizzare la codifica UTF-8 durante l'intero processo. La stringa JSON viene prima codificata in UTF-8 e successivamente codificata utilizzando android.util.Base64 con le opzioni NO_WRAP e URL_SAFE. Ciò corrisponde a RFC 3548, sezione 4.