BigCommerce API Connection
Prepare BigCommerce API account details for the Next-Cart migration service.
BigCommerce API Connection
Section titled “BigCommerce API Connection”A valid BigCommerce API connection gives Next-Cart the authorized platform access required by the selected migration path.
The goal is to create a store-level API account and prepare the values Next-Cart needs for connection testing.
When to use this guide
Section titled “When to use this guide”Use this guide when:
- the selected platform is BigCommerce;
- Next-Cart asks for BigCommerce API credentials;
- you can access the BigCommerce store control panel;
- you can create or manage store-level API accounts.
Prerequisites
Section titled “Prerequisites”| Requirement | Why it matters |
|---|---|
| Store control panel access | Store-level API accounts are created from the BigCommerce control panel. |
| Permission to manage API accounts | You need permission to create or delete store-level API credentials. |
| Migration scope | API scopes should cover the data types selected for migration. |
| Secure credential handling | Client secrets and access tokens should be protected. |
Required values
Section titled “Required values”| Value | Where to find it | Notes |
|---|---|---|
| API Path | Store-level API account credentials file or credential screen. | This is the store API URL. |
| Access Token | Store-level API account credentials. | Most REST requests use this token. |
| Client ID | Store-level API account credentials. | Enter it if Next-Cart asks for it. |
| Client Secret | Store-level API account credentials, if requested. | Treat it as sensitive. Enter it only if Next-Cart asks for it. |
Create a store-level API account
Section titled “Create a store-level API account”- Sign in to the BigCommerce control panel.
- Open Settings.
- Open Store-level API accounts.
- Create a new API account.
- Choose a store-level API credential type when prompted.
- Use a clear name such as Next-Cart Migration.
- Grant the minimum read permissions needed for the selected migration scope, such as Products, Customers, Orders, and Store Information.
- Save the API account.
- Download the credentials file if BigCommerce provides one.
- Copy the API Path, Access Token, and Client ID if requested by Next-Cart.
Enter the values in Next-Cart
Section titled “Enter the values in Next-Cart”In Next-Cart, enter the BigCommerce API Path, Access Token, and Client ID if the field appears.
Use values from the API account created for the store in the purchased migration path.
Expected result
Section titled “Expected result”Next-Cart has the BigCommerce store-level API details required for connection testing.
Verify the connection
Section titled “Verify the connection”| Check | Pass condition |
|---|---|
| API account | The API account exists in the BigCommerce control panel. |
| API Path | The API Path is copied from the credential screen or credentials file. |
| Access Token | The token is copied exactly and protected. |
| Scopes | The account has access to the selected data types. |
| Connection test | Next-Cart verifies access without authentication or scope errors. |
If the connection fails
Section titled “If the connection fails”| Issue | What to check |
|---|---|
| Access token rejected | Re-copy the token from the credential file or create a new API account. |
| API Path rejected | Confirm the API Path belongs to the intended store. |
| Scope or permission error | Grant the required store resource scopes or create a new API account with the correct permissions. |
| Client ID requested but missing | Check the credentials file and enter the Client ID if Next-Cart asks for it. |
| Credentials exposed | Delete the API account and create a new one. |
Security cleanup
Section titled “Security cleanup”After migration work is complete and verified, delete the temporary BigCommerce API account if it is no longer needed.
Deleting an API account is not reversible. Confirm that no other integration depends on it before deletion.
Next step
Section titled “Next step”| Situation | Go to |
|---|---|
| API values are ready | Verify Platform Connections |
| You need general API setup guidance | Set Up an API Connection |
| The connection test fails | Troubleshoot Connection Setup |