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 procedura, dopodiché potranno aggiungere la propria carta a Google Wallet.
Questa guida fornisce una panoramica della procedura di implementazione necessaria per attivare il programma di carte regalo per questa funzionalità.
Panoramica
Per iniziare, assicurati di aver configurato in precedenza il progetto e di avere accesso all'API Google Wallet.
Devi seguire questi quattro passaggi per implementare la funzionalità di accesso per il tuo programma di carte regalo:
- Configura un corso 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.
Configurare una classe di test in Google Wallet
Determina l'URL di accesso e 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 informazioni dettagliate su come condividere l'accesso a Google Pay e Wallet Console con altre persone, consulta Informazioni sulla pagina Utenti.
Per completare la verifica della funzionalità dell'implementazione durante il processo di sviluppo, contattaci utilizzando il widget di contatto dell'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 utilizza 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 in cui un utente possa 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.
- Utilizza la crittografia
HTTPScon un certificato valido per garantire che i dati utente vengano trasmessi in sicurezza. - Assicurati di avere un tempo di attività pari ad almeno il 99,9% della tua pagina di accesso.
Quando viene presentata la pagina di accesso, Google Wallet crea un WebView Android e viene inviata una richiesta POST all'URL fornito. I dati utente vengono forniti nel parametro SharedDataType, incluso nella richiesta POST utilizzando il tipo di contenuto
application/x-www-form-urlencoded e la codifica UTF-8. Il valore del parametro SharedDataType
è un oggetto JSON con codifica 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 ritrasferire la carta regalo su Google Wallet reindirizzando a un link che segue la struttura
https://pay.google.com/gp/v/save/{jwt_generated}La lunghezza di sicurezza di un URL è di 2000 caratteri. I tuoi link devono rimanere 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 nella seguente immagine. L'implementazione di tutte le azioni tra "Il tuo server" è 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 un'attenta revisione dell'implementazione che conferma la funzionalità corretta in combinazione con l'app Google Wallet, la funzionalità di accesso con carta regalo verrà lanciata pubblicamente per il tuo programma di carte regalo. In questo modo, qualsiasi utente potrà vedere il programma e utilizzare questa funzionalità.
Per garantire un'esperienza utente ottimale, verranno eseguiti controlli periodici dell'implementazione di Accesso per garantire la conformità continua ai requisiti della funzionalità. In caso di discrepanze, riceverai una notifica e la funzione di accesso potrebbe essere disattivata 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 consentono di decodificare e eseguire il debug dei token durante il processo di sviluppo, in modo da verificare i contenuti che invii. Tieni presente che Google non ha alcuna affiliazione e non consigliano espressamente queste terze parti.
- Come gestiamo correttamente i dati di SharedDataType con codifica Base64?
- Assicurati di utilizzare la codifica UTF-8 durante l'intero processo. La stringa JSON viene prima codificata in UTF-8 e successivamente utilizzando android.util.Base64 con le opzioni NO_WRAP e URL_SAFE. Ciò corrisponde a RFC 3548, sezione 4.