BigCommerce

Overview of Violet's BigCommerce integration for channel developers

BigCommerce is an enterprise-focused ecommerce platform with a comprehensive REST API and advanced webhook support. Merchants connect to Violet by providing API credentials either through an OAuth app flow or directly via Store Level API credentials.

Connection

BigCommerce supports two connection paths:

OAuth (Recommended) — Merchants authorize through the BigCommerce App Marketplace. Violet receives a token exchange with client_id, access_token, and store_hash automatically.

Store Level API — Merchants generate credentials directly in their BigCommerce store admin and provide them manually. This requires the store URL (e.g. https://store-{hash}.mybigcommerce.com), Client ID, Client Secret, and Access Token.

Required API Scopes

When connecting via Store Level API, Violet validates that all of the following scopes are present:

Scope	Access Level
store_v2_default	Default store access
store_v2_customers	Customers (modify)
store_cart	Carts (modify)
store_v2_orders	Orders (modify)
store_v2_information_read_only	Store information (read-only)
store_checkout	Checkout (modify)
store_v2_products_read_only	Products (read-only)

Violet will return an error listing any missing scopes during the connection attempt.

Webhooks

Webhooks are registered automatically when a merchant connects. Violet listens for order and product lifecycle events. Webhook signatures are validated on all inbound requests.

Notable Behavior

• Coupon codes: BigCommerce supports coupon codes natively. Use Coupon Codes (not Promotions) when creating discount codes for use with Violet-submitted orders.

• Refunds: Refunds submitted through Violet may appear as "offline" in BigCommerce — this is expected behavior.

• Rate limits: BigCommerce enforces rate limits of approximately 450 requests per 30 seconds. Violet handles retries with exponential backoff.

• Product variants: BigCommerce uses a named option/value system for variants. Violet maps these to its unified variant model automatically.