Shopify Guide (Custom, OAuth App)

Shopify Configuration Guide (Custom, OAuth App)

Create a custom Shopify app. Make sure you have an active Rutter account and can access dashboard.rutterapi.com. Also make sure you have a test Shopify store you can connect to in order to test the flow. You can create a new Shopify store by going to https://www.shopify.com/website

  1. Create a Shopify Partners Account at https://partners.shopify.com/signup
  2. Create and setup your Shopify app:
  3. Go to Apps → All apps → Create app
  4. Click on 'Create app manually' App
  5. Add your company name and the generated URLS (you can find your Rutter organization ID here):
    • App url - https://production.rutterapi.com/shopify/proxy/${YOUR_RUTTER_ORG_ID}/app-url
    • Redirect url - https://production.rutterapi.com/shopify/proxy/${YOUR_RUTTER_ORG_ID}/redirect-url URLs
  6. Click 'App setup' on the left hand side menu. Scroll down to the 'GDPR mandatory webhooks' section and paste in the generated Rutter webhook for all three fields: https://production.rutterapi.com/shopify/proxy/${YOUR_RUTTER_ORG_ID}/hmacwebhooks GDPR Mandatory Webhooks
  7. Click "Save" after the GDPR information is entered
  8. Go back to the app overview page
  9. Copy and paste the 'API Key' and 'Secret API Key' into your Rutter dashboard platform credentials: https://dashboard.rutterapi.com/platforms/shopify Keys
  10. Create a development Shopify store (or use one that you already have). You can do this from your app overview page by clicking on the 'Select Store' button in the 'Test your app' section. Store
  11. Click on 'Create new store' Store
  12. Select 'Development Store' and enter your desired test store name, store URL, and login credentials. You do not need to check developer preview Store
  13. Select store purpose as test an app or theme. Hit save and your test store will be created. Store
  14. Go to your stores tab. Make sure you are logged into the store on the Store page. Then go back to your apps home page, click into your test app, and click on test on development store. Find the store you would like to test and click install App Store Store Store
  15. Click Install Anyway on the popup as this allows you to get the test stores data Install
  16. Once successfully authenticated, you will be redirected to the page that you set for the 'Direct App Install Redirect URL' in your Rutter dashboard. You will then be able to see the test store you created a connection for in your Rutter dashboard (you may need to refresh the connections page) and you can start development!