Guides
How to Access the WhiskeyMate Swag Shop and Track Your Orders
Shop official WhiskeyMate merch and view order history directly from the app
1 found this helpful
<h2>Overview</h2>
<p>WhiskeyMate’s Swag Shop is a web-based store that you can open from the mobile apps. When you open the store from inside WhiskeyMate, the app passes your current Firebase sign-in token to the store so the website can automatically sign you in.</p>
<h2>Open the Swag Shop</h2>
<ul>
<li><strong>iOS</strong>: Open the main menu (from your collections/profile area) and tap <strong>Swag Shop</strong>. WhiskeyMate will fetch your Firebase ID token and open <code>https://whiskeymate.net/store.html?idToken=...</code> in your browser.</li>
<li><strong>Android</strong>: Open the app menu, expand <strong>Swag Shop</strong>, then choose <strong>Store</strong>. The app opens <code>https://whiskeymate.net/store.html?idToken=...</code> in your browser.</li>
</ul>
<h3>How automatic sign-in works (web)</h3>
<ul>
<li>The Swag Shop website reads the <code>idToken</code> query parameter, calls <code>/verify-id-token</code> to exchange it for a Firebase <em>custom token</em>, then signs in with that custom token.</li>
<li>After signing in, the website removes the <code>idToken</code> from the URL (so the token isn’t left sitting in your address bar).</li>
</ul>
<h2>Checkout & fulfillment (high level)</h2>
<ul>
<li><strong>Payments</strong>: Checkout is handled via Stripe on the Swag Shop website.</li>
<li><strong>Fulfillment</strong>: Products are pulled from Printful and orders are submitted to Printful for fulfillment and shipping. Shipping options depend on your destination address.</li>
</ul>
<h2>Track your orders (inside the app)</h2>
<ul>
<li><strong>iOS</strong>: Tap <strong>Order History</strong> to open the in-app <strong>Order Status</strong> screen.</li>
<li><strong>Android</strong>: Open the menu → <strong>Swag Shop</strong> → <strong>Orders</strong> to open <strong>Order Status</strong>.</li>
</ul>
<h3>What you’ll see in Order Status</h3>
<ul>
<li><strong>Order list</strong>: Each order shows a date, a Payment/Intent ID, and a status badge.</li>
<li><strong>Expandable details</strong>: Items (variant name × quantity), shipping address, and any emails recorded for that order.</li>
<li><strong>Order timeline</strong>: A step-by-step timeline (Draft → Submitted → Pending → In Progress → Partial → Fulfilled → Shipped), based on the order status.</li>
<li><strong>View Full Order</strong>: Opens <code>https://whiskeymate.net/order-status.html?id=<paymentIntentId></code> in your browser.</li>
</ul>
<h2>Behind the scenes (order history API)</h2>
<ul>
<li>Both iOS and Android fetch your order history by sending your Firebase ID token as an <code>Authorization: Bearer ...</code> header to the WhiskeyMate site’s <code>/order-history</code> endpoint.</li>
</ul>
<h2>Troubleshooting</h2>
<ul>
<li><strong>Store won’t load or doesn’t recognize you</strong>: Make sure you’re signed into WhiskeyMate, then open the Swag Shop from inside the app again so it can pass a fresh token.</li>
<li><strong>No orders show up</strong>: The Order Status screen will show a “No orders found” message and also provides a merch promo so you can browse products.</li>
<li><strong>Status feels behind</strong>: Fulfillment/shipping updates depend on the provider’s processing and can take time to reflect in the timeline.</li>
</ul>
1 found this helpful