Choose your auth model
API Key (single merchant): Best if you are a shop owner building an integration for your own store. The API key belongs to your merchant account; each shop needs its own key.OAuth App (multi‑merchant): Best if you are building an app for many shops. Examples: a POS platform that integrates with Rise, a Shopify app that merchants can install, or any multi-tenant application. Each merchant installs your app; your app authenticates via OAuth using your App ID/Secret and the merchant's instanceId.If you build only for your own store → use API Key. If you build an app others can install → use OAuth App.
API Key Authentication
Perfect for single merchant integrations where you need direct access to your own store data.
Best for:• Shop owners building custom integrations• Direct store-to-store connections• Simple server-side applications
OAuth App Authentication
Ideal for multi-tenant applications that need to access multiple merchant accounts securely.
Best for:• Third-party app developers• Multi-merchant platforms• SaaS applications