# Checkout Everywhere Quickstart

> Sell a product from a checkout link or a scannable QR code.

- **Bolt handles** the checkout page and payment collection.
- **Your store owns** the product catalog, order records, and fulfillment.

Source: https://help.boltapp.com/products/checkout-everywhere

<aside className="bolt-quickstart-summary not-prose" aria-labelledby="quickstart-outcome">
  <div className="bolt-quickstart-summary__header">
    <h2 id="quickstart-outcome">
      What you'll build
    </h2>

    <span className="bolt-quickstart-summary__time">
      <Icon name="clock" size="14" aria-hidden="true" />

       Est. 30–45 min
    </span>
  </div>

  <ul className="bolt-quickstart-summary__results">
    <li>
      <Icon name="circle-check" aria-hidden="true" />

      <span>Connected test catalog</span>
    </li>

    <li>
      <Icon name="circle-check" aria-hidden="true" />

      <span>Checkout link and QR code</span>
    </li>

    <li>
      <Icon name="circle-check" aria-hidden="true" />

      <span>Verified store order</span>
    </li>
  </ul>
</aside>

## Your integration steps [#your-integration-steps]

<nav className="bolt-quickstart-steps not-prose" aria-label="Quickstart steps">
  <ol>
    <li>
      <a href="#1-connect-store"><span className="bolt-quickstart-steps__number">1</span><span className="bolt-quickstart-steps__label">Connect store</span></a>
    </li>

    <li>
      <a href="#2-configure-checkout"><span className="bolt-quickstart-steps__number">2</span><span className="bolt-quickstart-steps__label">Configure checkout</span></a>
    </li>

    <li>
      <a href="#3-create-link"><span className="bolt-quickstart-steps__number">3</span><span className="bolt-quickstart-steps__label">Create link</span></a>
    </li>

    <li>
      <a href="#4-create-qr"><span className="bolt-quickstart-steps__number">4</span><span className="bolt-quickstart-steps__label">Create QR</span></a>
    </li>

    <li>
      <a href="#5-verify-order"><span className="bolt-quickstart-steps__number">5</span><span className="bolt-quickstart-steps__label">Verify order</span></a>
    </li>
  </ol>
</nav>

**This flow:** BigCommerce test store and Bolt Payments sandbox.

## Before you begin [#before-you-begin]

Have these ready before the estimated integration time begins.

| Requirement     | What you need                                                                                                                                                                                        |
| --------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Test store      | BigCommerce administrator access and one available physical product with a single variant.                                                                                                           |
| Sandbox account | A [Bolt merchant account](https://merchant.boltapp.com/onboarding/get-started) with Checkout Everywhere and Bolt Payments enabled for sandbox testing. Account setup is separate from this estimate. |

**Platform support**

The checkout link, QR code, and order verification steps work the same for any store. The store connection steps use BigCommerce; other platforms are linked below, and a store without a supported platform uses the [Custom API setup](https://help.boltapp.com/products/checkout-everywhere/set-up/custom-api/).

<IntegrationTable>
  <IntegrationRow label="Commerce Platforms">
    <IntegrationLink href="/platforms/shopify-checkout-everywhere" brand="shopify">
      Shopify
    </IntegrationLink>

    <IntegrationLink href="https://help.boltapp.com/products/checkout-everywhere/set-up/woocommerce/" brand="woocommerce">
      WooCommerce
    </IntegrationLink>

    <IntegrationLink href="https://help.boltapp.com/products/checkout-everywhere/set-up/magento/" brand="magento" title="Adobe Commerce">
      Adobe Commerce
    </IntegrationLink>

    <IntegrationLink href="https://help.boltapp.com/products/checkout-everywhere/set-up/sfcc/" brand="salesforce" title="Salesforce Commerce Cloud">
      Salesforce
    </IntegrationLink>
  </IntegrationRow>
</IntegrationTable>

## 1. Connect store [#1-connect-store]

1. In your BigCommerce test store, open **Settings > Store-level API accounts > Create API Account**. Select **V2/V3 API Token** and name it **Bolt sandbox**.
2. Give it **Carts: modify**, **Orders: modify**, and **Products: read-only** access, then save. Copy the **Access Token** and the store hash from the API path. Keep the token private.
3. Open [Bolt sandbox Integrations](https://merchant-sandbox.boltapp.com/integrations), select **BigCommerce**, and enter that store hash and access token.
4. Select **Connect BigCommerce** and wait for the product catalog to import.

The store hash is the value after `/stores/` in BigCommerce's API path. See [BigCommerce API accounts](https://docs.bigcommerce.com/developer/docs/overview/api-fundamentals/api-accounts) for account permissions.

### Validate connection [#validate-connection]

Confirm the catalog count increases and your test product is available. Check that you connected the test store, not your live store. If the catalog stays empty, correct the connection before creating a link.

## 2. Configure checkout [#2-configure-checkout]

1. Open [sandbox Payments](https://merchant-sandbox.boltapp.com/payments). Select **Bolt Payments** and configure **Immediate Capture** for the product's currency.
2. Open [Business Information](https://merchant-sandbox.boltapp.com/administration/business-info). Save the shopper support email and phone number under **Support Contact Information**.
3. Open [Checkout settings](https://merchant-sandbox.boltapp.com/checkout/configuration), add your store logo, and publish the change.
4. In BigCommerce, confirm your product is in stock and can ship to your test address. Record its price, currency, and expected shipping/tax amounts.

### Validate settings [#validate-settings]

Reopen Payments and confirm Immediate Capture is saved. Confirm the support details and logo belong to the test store. Do not continue if Bolt Payments or the product currency is unavailable for your division.

## 3. Create link [#3-create-link]

1. Open [Checkout Everywhere](https://merchant-sandbox.boltapp.com/checkout-everywhere) and select **Create Campaign**.
2. Name it **Sandbox quickstart** and select **Create campaign**.
3. Inside that campaign, select **Create Links**. Select the campaign and your intended channel.
4. Choose **Direct to checkout**, search for the test product, and select its variant. Leave promotional codes and optional tracking fields empty for this first test.
5. Select **Create Link** and copy the generated URL from its table row.

### Validate link [#validate-link]

Open the copied link in a new tab. Confirm the product, variant, quantity, price, currency, branding, and support details. Keep the generated URL unchanged and private while testing.

## 4. Create QR [#4-create-qr]

1. Return to the campaign and open your link's row.
2. Under **Share your link**, select **Create** beside the QR code icon.
3. Select **Download QR code** to save the PNG.
4. Scan it with a phone camera and open the destination.

### Validate QR [#validate-qr]

The scan must open the same product and variant as the copied link. Try the QR code at its intended display size; confirm it is readable without zooming. Keep this checkout open for the next step.

## 5. Verify order [#5-verify-order]

1. In the checkout opened from the QR code, enter your test shopper's details and supported shipping address.
2. Check the shipping, tax, currency, and final total against the store's settings.
3. Use the [Bolt Payments approved test card](/getting-started/test-cards#bolt-payments): `4111 1111 1111 1111`, expiration `03/30`, CVV `737`. Submit one payment and save the confirmation details.
4. Open [sandbox Transactions](https://merchant-sandbox.boltapp.com/transactions). Find the purchase and confirm its completed payment, amount, currency, and order number.
5. Open **Orders** in BigCommerce. Find the matching order and compare the product, variant, quantity, shopper, and total.

### Validate purchase [#validate-purchase]

You are done when the link and QR code reach the correct checkout, the payment completes, and the matching order exists in BigCommerce. A generated link or checkout confirmation alone is not enough. If payment exists but the store order is missing, investigate that transaction before trying another purchase.

## Test before sharing [#test-before-sharing]

Run the [Checkout Everywhere test plan](/products/checkout-everywhere-test-plan). To disable a test link, open its row, select **Deactivate Link**, and confirm; test both the copied URL and QR code afterward.

Before a real campaign, configure your production store and Bolt Payments account, generate production links/QR codes, and complete [production readiness](https://help.boltapp.com/developers/production-readiness-guides/). Sandbox links do not establish live payment or fulfillment readiness.
