> For the complete documentation index, see [llms.txt](https://developer.esw.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://developer.esw.com/light-touch-integration/integrate-with-lti/bigcommerce.md).

# BigCommerce

ESW Light Touch Integration (LTI) lets you connect ESW services to your BigCommerce storefront.

This integration supports:

* Country Selector
* Dynamic Pricing
* Checkout
  * User Data Sent to Checkout
  * Stored Cards in Checkout
* Returns Integration
* Order Status Synchronization

### Integration overview

{% stepper %}
{% step %}

#### Create the API account

Create a BigCommerce API account and grant ESW the required scopes.
{% endstep %}

{% step %}

#### Share the credentials with ESW

Provide the client ID, client secret, and access token so ESW can generate your script URL.
{% endstep %}

{% step %}

#### Add the ESW script

Create a storefront script in BigCommerce Script Manager and load the ESW script URL on all pages.
{% endstep %}

{% step %}

#### Maintain the script later if needed

You can edit or remove the script from Script Manager at any time.
{% endstep %}
{% endstepper %}

### Step 1: Set up the API account and permissions

Set up a BigCommerce API account and grant ESW the permissions needed for the integration.

1. Log in to your BigCommerce store.
2. Open the dashboard home page.
3. In the left navigation, go to *Advanced Settings*.
4. Select **API Accounts**.
5. Click **Create API Account**.
6. Set the following scopes:

| **Parameter**        | **Scope**    |
| -------------------- | ------------ |
| Cart                 | Modify       |
| Orders               | Modify       |
| All other parameters | \<No change> |

7. Click **Save**.
8. Copy and store the **Client ID**, **Client Secret**, and **Access Token** shown in the dialog.

You cannot view these values again after closing the dialog. BigCommerce also downloads a `.txt` file with the same credentials.

9. Share these credentials with ESW KeyVault.

ESW uses these credentials to generate your script URL. You will add that URL to BigCommerce Script Manager in the next step.

{% hint style="info" %}
You need the ESW-provided script URL before you can complete the storefront setup. Contact your ESW point of contact if you do not have it yet.
{% endhint %}

### Step 2: Add the custom script in BigCommerce

Use BigCommerce Script Manager to load the ESW script across your storefront.

1. Log in to your BigCommerce store.
2. Open the dashboard home page.
3. In the left navigation, go to *Storefront*.
4. Open *Script Manager*.

From Script Manager, you can:

* Create a custom script
* Edit a custom script
* Delete a custom script

{% tabs %}
{% tab title="Create a custom script" %}

1. On the *Script Manager* page, click **Create a Script**.
2. Open the script creation page.
3. Enter the **Name of script** and, if needed, a **Description**.
4. For *Location on page*, select **Head**.
5. For *Select pages where script will be added*, select **All pages**.
6. For *Script category*, select **Essential**.
7. For *Script type*, select **URL**.
8. For *Load method*, select **Default**.
9. Paste the ESW-provided script URL into the *Script URL* field.
10. Click **Save**.
11. Confirm you see the **Script Created** success message.
12. Verify the script appears in the Script Manager list.
    {% endtab %}

{% tab title="Edit a custom script" %}

1. In Script Manager, go to the installed scripts section.
2. Open the three-dot menu for the script.
3. Click **Edit**.
4. Make the required changes and click **Save**.
5. Confirm you see the **Script Saved** success message.
   {% endtab %}

{% tab title="Delete a custom script" %}

1. In Script Manager, go to the installed scripts section.
2. Open the three-dot menu for the script.
3. Click **Delete**.
4. Confirm the deletion in the dialog.
5. Confirm you see the **Script deleted** success message.
   {% endtab %}
   {% endtabs %}


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://developer.esw.com/light-touch-integration/integrate-with-lti/bigcommerce.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.