Step 1: Create the Blackcart Custom App and Generate Credentials

1. From your Shopify Admin, go to Apps
2. Click on Develop Apps
3. Select Create an App
4. In App name field, enter "Blackcart", and in the App developer field, enter your Admin email address. Click Create app.
5. Under Select your access scopes to get started, click Configure Admin API scopes and set the following permissions:
   • Analytics:Read and write
   • Customers:Read and write
   • Discounts:Read and write
   • Draft Orders: Read and write
   • Fulfillment services:Read and write
   • Inventory:Read and write
   • Locations:Read and write
   • Online Store pages:Read and write
   • Order editing:Read and write
   • Orders:Read and write
   • Payment terms:Read and write
   • Price rules:Read and write
   • Product listings:Read and write
   • Products:Read and write
   • Reports:Read 
   • Shipping:Read and write
   • Shop locales:Read and write
   • Themes:Read
6. Click Save in the bottom right corner.
7. From the top of the page, open the Configuration tab.
8. Under the Storefront API integration card, click Configure and set the following permissions:
   • Checkout:
     • unauthenticated_write_checkouts
     • unauthenticated_read_checkouts
   • Customers:
     • unauthenticated_write_customers
     • unauthenticated_read_customers
     • unauthenticated_read_customer_tags
   • Products:
     • unauthenticated_read_product_listings
     • unauthenticated_read_product_inventory
     • unauthenticated_read_product_pickup_locations
     • unauthenticated_read_product_tags
   • Selling plans:
     • unauthenticated_read_selling_plans
9. Click Save in the bottom right corner.
10. Click Install App in the top right corner. From the pop-up, click Install.
11. You'll then be automatically be redirected to the API credentials tab where you will find the credentials needed to complete Step 2 below.

Step 2: Share the API Credentials with Blackcart

1. Keep your Shopify custom App set-up page (above) open in one tab of your window. Example screenshot from Shopify Admin
2. Open the Blackcart onboarding page in another tab, and make sure you're on the App Setup tab. If you've closed your Blackcart onboarding page, you can reopen it following this link: https://merchant.blackcart.com/auth/login.
3. From Shopify, copy and paste the following fields into the Blackcart onboarding page.
   • Admin API access token ***Note - to protect your data, you'll only be able to reveal and copy and paste your Admin API token once. Copy and save your Admin API access token in a secure place in case you need to access it in the future. If you forget to do this and can no longer access your Admin API access token, you will need to delete the custom app and start again from Step 1***
   • Storefront API access token
   • API key
   • API secret key 
4. Once you have successfully copied and pasted the 4 fields above into the Blackcart onboarding page, the Verify Credentials button should be enabled.
5. Click Verify Credentials to complete the App Setup task. Once your credentials are verified, the status will update to "Connected", and from there you will be able to click Next to move to the Store Info tab.

• Note that you will get an error message when attempting to Verify Credentials if you entered in the incorrect Shopify Domain in the initial Get Started page (screenshot below).
• Since you do not have the option to "go back" to update your Shopify domain, please contact our Merchant Support team via the Help chat widget and we will guide you through next steps for resolving.