Store Configuration

Introduction

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

Shopify

Create a private app in Shopify

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

🚧

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

  1. Go to https://{your-store}.myshopify.com/admin/apps.
  2. Navigate to Apps>Manage private apps.
  1. You may need to Enable private app development.
  1. Click Create new private app.
  2. Private app name: Shogun Frontend
  3. Emergency developer email: [email protected]
  4. Add inventory permissions: ADMIN API PERMISSIONS > Inventory > Read access
  5. Add product permissions: ADMIN API PERMISSIONS > Products > Read access
  6. Add product listing permissions: ADMIN API PERMISSIONS > Product listings > Read access
  1. Check Allow this app to access your storefront data using the Storefront API.
  2. Check all items under Storefront API Permissions.
  1. Click Save
  2. Make a note of the Password, Shared Secret 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.
  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 Password (shppa_*).
  3. Admin Shared Secret (shpss_*).
  4. Storefront access token (at the bottom).

📘

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

  1. User emails that require access.

📘

Note: Must be Google email accounts!

  1. /<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!


What’s Next
Did this page help you?