Introduction

This guide will walk you through the steps to configure your Shopify or BigCommerce Store for Shogun Frontend.

Shopify

🚧

Multi-Store Setup Shopify Limitation

When requesting an additional staging, sub-brand or regional store to be created that shares the same Shopify instance (i.e. the same .myshopify.com domain) you will need to create an additional private app per store and send us those credentials. Otherwise, the Shopify Bulk Operation we use to keep your product data in sync with our CMS will clash and your live Shogun Frontend production store will get out of sync with your Shopify instance.

For Example:
For your Shogun Live Store connected to storename.myshopify.com create a new private app called “Shogun Frontend - Live” and send us those credentials.
For your Shogun Staging Store connected to storename.myshopify.com create a new private app called “Shogun Frontend - Staging” and send us those credentials.

Create a private app in Shopify

1. If you haven't already, create a store in Shopify.

🚧

Note

Some stores might use different terms for the steps in this guide. Check the table below:

Old	New
Shared Secret	API secret key
Password	Admin API access token

🚧

Developer preview should not be enabled when creating a development store in Shopify. Doing so will prevent connecting the domain.

2. Go to https://{your-store}.myshopify.com/admin/apps.
3. Navigate to Apps > Develop apps for your store.

4. Click Create an app.
5. App name:
   5.1 For your production store Shogun Frontend
   5.2 For your staging store Shogun Frontend - Staging
6. App developer email: [email protected] — this needs to be added as collaborator to your store.
7. Click Create app.
8. Next, configure the Admin API scopes and Storefront API scopes.

9. For Admin API scopes, select the following and click Save:

• Add inventory permissions: ADMIN API PERMISSIONS > Inventory > Read access
• Add product permissions: ADMIN API PERMISSIONS > Products > Read access
• Add product listing permissions: ADMIN API PERMISSIONS > Product listings > Read access

10. Go back to Configuration, check all items under Storefront API access scopes and click Save.

12. Click Install app
13. Make a note of the Admin API access token, API secret key and Storefront Access Token.

---

📘

Products need to be published on the Shogun Frontend sales channel in order to pull into our CMS.

Persist users logged state

Follow the steps below to prevent users from being logged out when they go to the checkout page.

📘

1. Log in to your Shopify store admin.
2. Go to Online Store > 'Preferences'.
3. Uncheck Enable Google reCAPTCHA on login, create account and password recovery pages.

Checkout experience

📘

Your checkout experience should be on a dedicated subdomain to avoid potential downtime. For example, a store using a domain like www.example.com should use a subdomain such as checkout.example.com or shop.example.com.

Send Shogun Necessary Information

Internal store set ups should be routed through the engineering team.

Send the following to any member of the Support team at Shogun via One Time Secret.

1. Shopify Platform Domain i.e.  https://{your-store}.myshopify.com.
2. Admin API access token (shpat_*).
3. Admin API secret key (shpss_*).
4. Storefront access token (at the bottom).

📘

Note: this is not the same as the API key!

5. User emails that require access.

📘

Note: Must be Google email accounts!

6. /<checkout_id>/checkouts/... Checkout ID from URL in the checkout page.

---

BigCommerce

Create New API Account

1. Click Advanced Settings from the lefthand sidebar menu.
2. Select API Accounts at the bottom of the list.
3. Create New API Account
4. Select v2/v3 Account.
5. Name the API [StoreName] - ShogunFrontend and Save.
6. Update permissions for the following options
   • Customers: Modify
   • Orders: Read Only
   • Products: Read Only
   • Carts: Modify
   • Checkout: Modify
   • Storefront API Tokens: Manage
7. Click Save and a text file with the following information will automatically download to your computer with the following information:
   • Access token
   • Client ID
   • Clients Secret
   • Name
   • API Path

Send Shogun Necessary Information

1. Please send us the text file along with the following information (via One Time Secret):
   • BigCommerce platform domain URL
   • Current live store domain
   • Names & emails for users that need access to the Shogun Frontend Store

📘

Note: Must be Google email accounts!

Adobe Commerce (Magento)

Create new API Integration

1. Click System
2. Under Extensions, click Integrations
3. Click Add New Integration
4. Under Integration Info:
   • Name the integration “Shogun Frontend”
   • Callback URL and Identity link URL can be left blank
5. Under API, select the following endpoints to provide access to:
   • Catalog (without Edit permission)
   • Carts
   • Stores
6. Save
7. Once your integration has been created, click Activate, then Allow
8. Note your Access Token

Install the Checkout Extension

In order to connect checkout, please install this PHP package on your Adobe Commerce (Magento) instance following our documentation here.

Provide Access

In order to efficiently troubleshoot, we need access to your Adobe Commerce (Magento) store.

1. Click System
2. Under Permissions, click All Users
3. Click Add New User
4. Please configure the following fields:
   • User Name: shogun
   • First Name: Shogun
   • Last Name: Integrations
   • Email: [email protected]
5. Password: generate a password and send it per instructions below
6. When setting the Role, ensure:
   • Role Scope is set to All
   • Role Resource has at least the following folders selected: Catalog, Customers, Carts, Stores, System

Send Shogun Necessary Information

Please send the following information via One Time Secret to Shogun Support here.

• Access Token from above step
• New User Password from above step
• The names and emails that need access the Shogun Frontend Site
• And finally, the domain of your Adobe Commerce (Magento) Site, found here:

📘

Note: Must be Google email accounts!