Shopify Quickstart
Accept a sandbox payment from a checkout link for a product in your Shopify store.
- Bolt handles hosted checkout and payment collection.
- Your store owns products, inventory, shipping settings, and order records.
Your integration steps
This flow: a Shopify test store, Checkout Everywhere, and Bolt Payments sandbox.
Before you begin
Have these ready before the estimated integration time begins. Account provisioning, app approval and distribution setup are separate; the estimate has not been measured in a live walkthrough.
| Requirement | What you need |
|---|---|
| Test store | Shopify admin access to create and install an app, with any required app scopes/distribution approved for this store. |
| Test product | One available physical product and a shipping address your test store serves. |
| Bolt sandbox | Checkout Everywhere and Bolt Payments enabled for your division. Confirm Shopify test-store connectivity with Bolt before beginning. |
Platform support
This guide is for Shopify. Supporting guides for this platform: Managed Checkout theme installation and the app connection reference. Checkout links on BigCommerce are covered by the Checkout Everywhere quickstart. Other platforms and custom web apps have their own quickstarts.
1. Create app
- In your Shopify admin, open Apps > Develop apps > Build apps in Dev Dashboard.
- Select Create app, name it Bolt sandbox, and select Create.
- Open Versions > Access. Grant read/write access to draft orders and orders, read access to products and discounts, and read access to all orders. Keep access limited to the scopes required by this integration.
- Select Release. On the app's Home tab, select Install app, choose your test store, and confirm Install.
- Open the app's Settings and copy its Client ID and Client Secret. Keep the secret private; it belongs in Bolt's connection form, never your theme.
Validate app
Confirm the app is installed on the intended test store with the required access. If Shopify requires approval or distribution changes before installation, finish that setup before continuing. The connection reference covers Partner distribution.
2. Connect store
- Open Bolt sandbox Integrations and select Shopify.
- Enter your test store URL and the app's Client ID and Client Secret.
- Select Connect Shopify and wait for the product catalog to import.
Validate connection
The catalog count increases and your test product appears. Confirm the store URL and product variant match your test store. If the catalog stays empty, check the app installation and access scopes before creating links.
3. Configure checkout
- Open sandbox Payments. Select Bolt Payments and configure Immediate Capture for the test product's currency.
- Open Business Information. Save your test store's support email and phone number under Support Contact Information.
- Open Checkout settings, add your store logo, and publish the change.
- In Shopify, confirm the test product is in stock. Record its variant, price, currency and expected shipping/tax for your test address.
Validate settings
Reopen Payments and confirm Immediate Capture is saved. Confirm the test currency is enabled and the support details belong to this store. Resolve unavailable payment settings with Bolt before taking a payment.
4. Create link
- Open Checkout Everywhere, select Create Campaign, name it Shopify sandbox, and create it.
- Inside the campaign, select Create Links and select the campaign and channel.
- Choose Direct to checkout, find your test product, and select its variant. Leave promotion and optional tracking fields empty for this first purchase.
- Select Create Link and copy the generated URL from the table row.
Validate link
Open the URL in a new tab. Confirm the intended product, variant, quantity, price, currency and branding. Keep the test link private. Do not substitute a production link if the sandbox catalog or link fails.
5. Verify order
- Enter your test shopper details and supported shipping address in the checkout opened from the link.
- Compare shipping, tax and final total with the test store's settings.
- Use the Bolt Payments approved test card:
4111 1111 1111 1111, expiration03/30, CVV737. Submit one payment and save its confirmation details. - Open sandbox Transactions and find the completed payment. Record its order number, amount and currency.
- Open Orders in Shopify. Find the matching order and compare shopper, product, variant, quantity and total.
Validate purchase
You are done when the Bolt payment and matching Shopify order agree. A generated link or browser confirmation alone is not proof. If the payment exists but the store order is missing, investigate that transaction before attempting another purchase.
Test before sharing
Run the Shopify test plan. It tests this link flow; theme-button placement and production lifecycle operations have separate launch checks.
When finished, open the test link's row in Checkout Everywhere, select Deactivate Link, and confirm. Before publishing a real campaign, configure production separately and complete production readiness. Test results here do not establish live fulfillment or refund readiness.