1. Getting Started
Installation & Shopify OAuth Setup
⏱️ 4 min read•📅 Updated 2 days ago
Installing SpotMetal into your Shopify store takes less than 2 minutes and requires zero code modifications to your backend database.
Prerequisites
Before installing, ensure your store meets the following basic requirements:
- A live or development Shopify store running any plan (Basic, Shopify, Advanced, or Plus).
- Store Owner or Staff permissions with access to Apps and Products.
- At least one product with defined metal attributes (e.g. Gold 14K, 18K, Silver 999).
✦ Free 7-Day Trial: Every paid plan comes with an unrestricted 7-day trial. You can test live formula updates and buyback workflows with zero risk.
Installing from the Shopify App Store
- Navigate to the official SpotMetal Shopify App Store Listing.
- Click Install. You will be redirected to your Shopify Admin authentication page.
- Review the requested permissions and click Install App to finalize the OAuth handshake.
Required OAuth Scopes Explained
SpotMetal operates strictly on the principle of least privilege. The following scopes are requested:
| OAuth Scope | Permission Type | Why SpotMetal Needs It |
|---|---|---|
| write_products | Read & Write | Updates variant price fields dynamically when spot market rates shift. |
| write_draft_orders | Read & Write | Generates official payout draft invoices for accepted customer scrap buybacks. |
| read_locations | Read Only | Determines local store branch availability for in-person bullion trade-ins. |
Initial Onboarding Wizard
Upon initial launch, SpotMetal greets you with a 3-step setup wizard:
- Select Base Currency: Choose USD ($), EUR (€), GBP (£), CAD, AUD, or 15+ global currencies.
- Choose Market Data Feed: Activate the built-in system feed (Edelmetalle.de) or connect your private API key.
- Create Default Formula: Set your initial manufacturing markup and weight multiplier.