Step 1. Connect Shopify

This guide will help you connect your Shopify store to Hypercape using the Dev Dashboard App method.

Steps

1. Log in to Hypercape BIZ

Log in to your Hypercape BIZ account at biz.hypercape.com. Enter your email address and password, then click \"Sign in\". You can also sign in with your Google account.

2. Navigate to Shopify Home

After logging in, navigate to the left sidebar and click on \"Shopify\" to expand the menu. Then select \"Home\" from the submenu.

3. Click Connect a Store

On the Shopify Home page, click the green \"Connect a store\" button to begin connecting your Shopify store to Hypercape.

4. Go to Shopify Admin

A modal window will appear asking for your Shopify credentials. Keep this window open and navigate to your Shopify Admin at admin.shopify.com in a new browser tab.

5. Open Account Menu

In your Shopify Admin dashboard, click on your account name in the top right corner of the screen to open the account menu.

6. Access Dev Dashboard

From the dropdown menu, click on \"Dev Dashboard\" to access the Shopify Developer Dashboard where you can create and manage your apps.

7. Click Create App

In the Dev Dashboard, click the \"Create app\" button in the top right corner.

8. Enter App Name

On the \"Create an app\" page, in the \"Start from Dev Dashboard\" section on the right, enter your desired app name (e.g., \"hypercape\") and click the \"Create\" button.

9. Configure API Scopes

After your app is created, you'll be taken to the app configuration page. Scroll down to the \"Access\" section and click \"Select scopes\" to configure the API permissions.

10. Select Required Scopes

In the "Select scopes" modal, search and enable the following Admin API scopes:

• Products: read_products, write_products

• Order editing: read_order_edits, write_order_edits

• Orders: read_orders, write_orders

• Fulfillment services: read_fulfillments, write_fulfillments

• Merchant managed fulfillment: read_merchant_managed_fulfillment_orders, write_merchant_managed_fulfillment_orders

• Third party fulfillment: read_third_party_fulfillment_orders, write_third_party_fulfillment_orders

• Custom fulfillment services: read_custom_fulfillment_services, write_custom_fulfillment_services

• Assigned fulfillment: read_assigned_fulfillment_orders, write_assigned_fulfillment_orders

Click "Done" after selecting all scopes.

Select the Products scope: read_products, write_products.

Select the Order editing scope: read_order_edits, write_order_edits.

Select the Orders scope: read_orders, write_orders.

Select fulfillment-related scopes (as shown in the modal).

Select the Custom fulfillment services scope: read_custom_fulfillment_services, write_custom_fulfillment_services.

Select the Assigned fulfillment scope: read_assigned_fulfillment_orders, write_assigned_fulfillment_orders.

For Existing Users: How to Update Permissions

If you already have a connected store and need to update your app permissions, follow these steps:

1. Go to Shopify Settings → Apps and sales channels

2. Click Develop apps in the top right corner

3. Select the HYPERCAPE app (or your custom app name)

4. Click Configure Admin API scopes

5. Enable ALL of the following permissions:

• Assigned fulfillment orders (read & write)

• Custom fulfillment services (read & write)

• Fulfillment services (read & write)

• Merchant-managed fulfillment orders (read & write)

• Orders (read & write)

• Third-party fulfillment orders (read & write)

⚠️ You must manually grant all 6 permissions above in your Shopify admin panel.

11. Release Your App

After configuring your scopes, scroll down to the bottom of the page and click the \"Release\" button to publish your app version with the selected permissions.

12. Install App to Your Store

In the \"Overview\" section, click the Install app button.

A confirmation dialog will appear showing the permissions your app needs. Click Install to complete the installation.

13. Go to Settings

Navigate to the \"Settings\" tab in the left sidebar to access your app credentials.

14. Copy Your Credentials

In the Settings page, you'll find your \"Credentials\" section containing your Client ID and Secret. Click the copy icon next to each field to copy these values.

15. Enter Your Credentials

Return to the Hypercape BIZ connection modal. Paste your copied Client ID and Client Secret into the corresponding fields. Enter your Shopify store URL (the part before .myshopify.com). Click \"Connect my store\" to complete the connection.

16. Connection Complete!

If you see the screen below with your store name listed, congratulations! Your Shopify store has been successfully connected to Hypercape. You can now start importing and managing products.

Need help?

If you encounter any issues during the setup process, contact us at [email protected].