bc-testing

BigCommerce Testing

Before writing code

Fetch live docs:

1. Web-search site:developer.bigcommerce.com testing for testing guidance
2. Web-search bigcommerce stencil theme testing for theme testing patterns
3. Web-search bigcommerce api testing sandbox for sandbox store setup

Testing Environments

Sandbox Stores

BigCommerce provides sandbox/trial stores for testing:

• Free trial stores (limited time)
• Partner sandbox stores (BigCommerce Partner Program)
• Use for: API testing, theme development, app development
• Never test against production stores

Test vs Production Credentials

• Create separate API credentials for test environments
• Use test/sandbox mode for payment gateways (Stripe test keys, PayPal sandbox)
• Use different webhook endpoints for test environments

API Testing

Testing REST API Calls

Use tools like Postman, Insomnia, or curl:

curl -X GET \
  https://api.bigcommerce.com/stores/{hash}/v3/catalog/products \
  -H 'X-Auth-Token: {token}' \
  -H 'Accept: application/json'

Automated API Tests

Write integration tests that exercise the BigCommerce API:

// Jest/Vitest example
describe('Products API', () => {
  it('should create a product', async () => {
    const response = await fetch(`${API_URL}/v3/catalog/products`, {
      method: 'POST',
      headers: { 'X-Auth-Token': TOKEN, 'Content-Type': 'application/json' },
      body: JSON.stringify([{ name: 'Test Product', type: 'physical', price: 9.99, weight: 1 }]),
    });
    expect(response.status).toBe(200);
    const data = await response.json();
    expect(data.data[0].name).toBe('Test Product');
    // Cleanup: delete the test product
  });
});

Testing Rate Limits

• Monitor X-Rate-Limit-Requests-Left header in tests
• Add delays between rapid API calls
• Test your retry/backoff logic

Testing Pagination

• Create enough test data to exceed one page
• Verify your pagination logic handles pageInfo / meta.pagination correctly
• Test edge cases: empty results, last page, single item