How to install a custom app in Shopify Admin and register to Magestore POS

Owned by Aurora Bui
Last updated: Mar 27, 2024
4 min read

I. Install a custom app

To use Magestore POS, we expect you to generate a custom app from Shopify Admin. Then configure this custom app to get access to Magestore POS.

Step 1: Create a new custom app

First, you need to open the Settings page of Shopify. In the App and sales channels tab:

  1. Click on the button “Develop apps”

    image-20240314-012352.png

     

  2. Click on Develop app → Allow custom app development

    image-20240105-041550.png

     

  3. Next, create an app

     

  4. Fill in the app name and select the app developer

     

  5. Click on the Create app button and move to step 2.

Step 2: Configure required scopes

To integrate Magestore POS, you must configure the Admin scope for the newly created custom app.

  • In the Configuration app of this custom app, click on the Configure button of Admin API integration

  • Select 19 scopes below :

    • write_assigned_fulfillment_orders

    • read_assigned_fulfillment_orders

    • write_customers

    • read_customers

    • read_discounts

    • write_draft_orders

    • read_draft_orders

    • read_inventory

    • read_locations

    • write_merchant_managed_fulfillment_orders

    • read_merchant_managed_fulfillment_orders

    • write_orders

    • read_orders

    • read_price_rules

    • read_product_listings

    • write_products

    • read_products

    • read_locales

    • write_third_party_fulfillment_orders

    • read_third_party_fulfillment_orders

When done, click on Save.

The Install app button will then be enabled. Click on that to complete creating a custom app.

The generated custom app will be shown as below image:

 

II. Register to Magestore POS

Step 1: Install the custom app and get a connection to Magestore POS

To activate the Magestore POS app, firstly you need to get 3 fields below from your custom app:

  • Access token

  • API key

  • API secret key

Remember that the Admin API access token can be only revealed once. So we suggest you save it in your browser for later usage.

Step 2: Register an account in Magestore POS

After getting the custom app's API access token and API key, access the Magestore POS URL: http://admin.pos.magestore.com/

In the Create an Account page, fill in all required fields

  • Store key: this is the prefix of your Shopify URL, in front of the .myshopify.com

  • Username: fill in an easy-to-remember username for login to both POS Admin and POS Checkout.

  • Password and Password confirmation: fill in at least 7 characters for passwords, with both numeric and alphabetical ones

If the login screen will be shown first, click on Sign up here button for registration.

Once you enter valid content, click the Sign-Up button to move to the Shopify Integration page.

Fill in the API access token, API key, and API secret key saved in the above step.

Then, click the Activate app button to start using the Magestore POS app.

There are two available pricing plans, Lite and Standard, to activate the app. Please Try for Free after activating the app successfully!

III. Login to POS and do the Checkout

Once you have activated the app successfully, set up POS data first, such as POS locations, roles, staff, etc.

To create a new POS, read HERE. You can also learn to create other POS data in our Userguide list.

  1. For further usage, access this URL to log in to POS Admin: http://admin.pos.magestore.com/

  1. For Checkout, go to this URL to open POS Checkout (or POS frontend): http://pos.magestore.com/

Here you can place orders, take payment, fulfill, or reorder, etc.