Come accedere allo Swag Shop di WhiskeyMate e tracciare i tuoi ordini

<h2>Panoramica</h2> <p>Lo Swag Shop di WhiskeyMate è un negozio online che puoi aprire dalle app mobili. Quando apri il negozio dall'interno di WhiskeyMate, l'app passa il tuo token di accesso Firebase corrente al negozio in modo che il sito web possa effettuare l'accesso automaticamente.</p> <h2>Aprire lo Swag Shop</h2> <ul> <li><strong>iOS</strong>: Apri il menu principale (dall'area delle tue collezioni/profilo) e tocca <strong>Swag Shop</strong>. WhiskeyMate recupererà il tuo token ID Firebase e aprirà <code>https://whiskeymate.net/store.html?idToken=...</code> nel tuo browser.</li> <li><strong>Android</strong>: Apri il menu dell'app, espandi <strong>Swag Shop</strong>, quindi scegli <strong>Store</strong>. L'app aprirà <code>https://whiskeymate.net/store.html?idToken=...</code> nel tuo browser.</li> </ul> <h3>Come funziona l'accesso automatico (web)</h3> <ul> <li>Il sito web dello Swag Shop legge il parametro di query <code>idToken</code>, chiama <code>/verify-id-token</code> per scambiarlo con un <em>token personalizzato</em> Firebase, quindi effettua l'accesso con quel token personalizzato.</li> <li>Dopo l'accesso, il sito web rimuove l'<code>idToken</code> dall'URL (in modo che il token non rimanga nella barra degli indirizzi).</li> </ul> <h2>Pagamento &amp; evasione ordini (panoramica)</h2> <ul> <li><strong>Pagamenti</strong>: Il pagamento viene gestito tramite Stripe sul sito web dello Swag Shop.</li> <li><strong>Evasione ordini</strong>: I prodotti provengono da Printful e gli ordini vengono inviati a Printful per l'evasione e la spedizione. Le opzioni di spedizione dipendono dall'indirizzo di destinazione.</li> </ul> <h2>Tracciare i tuoi ordini (all'interno dell'app)</h2> <ul> <li><strong>iOS</strong>: Tocca <strong>Cronologia ordini</strong> per aprire la schermata <strong>Stato dell'ordine</strong> all'interno dell'app.</li> <li><strong>Android</strong>: Apri il menu → <strong>Swag Shop</strong> → <strong>Ordini</strong> per aprire <strong>Stato dell'ordine</strong>.</li> </ul> <h3>Cosa vedrai in Stato dell'ordine</h3> <ul> <li><strong>Elenco ordini</strong>: Ogni ordine mostra una data, un ID Pagamento/Intento e un badge di stato.</li> <li><strong>Dettagli espandibili</strong>: Articoli (nome variante × quantità), indirizzo di spedizione e qualsiasi email registrata per quell'ordine.</li> <li><strong>Cronologia ordini</strong>: Una cronologia passo-passo (Bozza → Inviato → In sospeso → In corso → Parziale → Evaso → Spedito), basata sullo stato dell'ordine.</li> <li><strong>Visualizza ordine completo</strong>: Apre <code>https://whiskeymate.net/order-status.html?id=&lt;paymentIntentId&gt;</code> nel tuo browser.</li> </ul> <h2>Dietro le quinte (API cronologia ordini)</h2> <ul> <li>Sia iOS che Android recuperano la cronologia dei tuoi ordini inviando il tuo token ID Firebase come header <code>Authorization: Bearer ...</code> all'endpoint <code>/order-history</code> del sito di WhiskeyMate.</li> </ul> <h2>Risoluzione dei problemi</h2> <ul> <li><strong>Il negozio non si carica o non ti riconosce</strong>: Assicurati di aver effettuato l'accesso a WhiskeyMate, quindi apri nuovamente lo Swag Shop dall'interno dell'app in modo che possa passare un token aggiornato.</li> <li><strong>Nessun ordine visualizzato</strong>: La schermata Stato dell'ordine mostrerà un messaggio "Nessun ordine trovato" e fornirà anche una promozione per il merchandising in modo che tu possa sfogliare i prodotti.</li> <li><strong>Lo stato sembra in ritardo</strong>: Gli aggiornamenti sull'evasione/spedizione dipendono dall'elaborazione del fornitore e possono richiedere tempo per essere visualizzati nella cronologia.</li> </ul>