This guide will walk you through setting up an extension store on Shopify using the Reach Embedded solution.

✅

Best practice

Shopify's webhooks are versioned to correspond with their API version. We strongly recommend updating your apps, including this Shopify custom app, to use the latest stable API version every quarter. See Use a new API version in the Shopify documentation for instructions on updating the webhook version.

Create an app

Install a custom API into your Shopify account to ensure smooth reporting and remittance on Reach’s end. Follow these easy steps to complete the process:

1. Sign in to Shopify.
2. Click Settings in the lower-left corner of the page, then click Apps and sales channels.

ℹ️

Note

If your store doesn’t have developer apps, click Allow custom app development to continue. You will see the following screen.

3. Click Allow custom app development again.
4. Click Develop Apps in the top-right corner of the App and sales channels page.

5. From the App development screen, click Create an app.

6. From the Create an app modal, type the app’s name for the settlement in the App name field. We recommend using “Reach Data” as the app name.

7. Click Create app.
8. Click Reach Data on the App development page.

9. From the Overview tab on the Reach Data page, click the Configuration tab.
10. Click Configure in the Admin API integration section. If you have already configured this integration, you can skip this step.
11. Under Admin API access scopes, use the Filter access scopes field to locate and select the following checkboxes.
    • read_orders
    • read_products
    • read_shopify_payments_payouts
    • read_shopify_payments_disputes
    • read_shopify_payments_accounts
    • read_shopify_payments_bank_accounts

12. Click Save. Your Admin API access scopes will appear under the Admin API section in the Configuration tab.

    

    
    

13. Click API credentials.

14. Click Install app under Access tokens to install the application and generate your access tokens.

15. On the Install Reach Data modal, click Install to add it to your store. Your API access token and API keys are now available on the API credentials tab.

16. Reveal, copy, and save the following keys to a safe place:

    • Admin API access token: To protect your data, you can only reveal and copy your Admin API token once.

    

    • API key

    • API secret key

    ❗️

    Important

    When saving API keys and tokens, you must store them securely. For example, keep confidential (secret) keys on your servers only and do not store them in version control systems. It helps protect your API keys from unauthorized access.

17. Reach will ask you to upload these keys to a secure location.