BigCommerce test plan
Verify the BigCommerce quickstart, reconcile payments and orders, and check the experience your store controls.
Run this plan after the BigCommerce Quickstart. These are acceptance criteria, not recorded results. All cases start Not run.
Fixtures and evidence
Use the test store and Bolt Payments sandbox division from the guide, one available physical product, a supported shipping address, and test cards. Record the app/theme version, date, case ID, Bolt transaction reference, store order ID, amounts and screenshots. Do not record keys, secrets or card details in evidence.
Use a fresh cart or purchase for each payment case. Keep the same product/variant fixture; wait for catalog/configuration updates before retesting. Reconcile uncertain outcomes before retrying. Preserve order evidence; do not refund or delete records as routine cleanup. Refund testing is a separate launch case using the platform refund guidance. Restore changed permissions and browser network settings after failure tests.
Mark Passed, Failed, or Blocked with evidence after execution. Baseline completion requires all applicable setup, checkout, payment and merchant-experience cases to pass. Missing required capabilities are Blocked. Additional launch cases do not imply the quickstart built those features.
App and Bolt connection
| Test | Input | Steps | Expected output | Result |
|---|---|---|---|---|
| BC-01: Sandbox configuration | Sandbox app and test division | 1. Inspect installed app. 2. Review payment keys and configuration mode. | Sandbox app, matching division and Full Bolt Checkout mode; no production credentials. | Not run |
| BC-02: Webhook destination | Known test store hash | 1. Open sandbox Webhooks. 2. Compare endpoint with store hash. | Endpoint is populated by the app and points to the intended BigCommerce store. | Not run |
| BC-03: Secret placement | Rendered copied theme and source | 1. Inspect script attributes/source. 2. Compare key types. | Only publishable key appears in theme; API key and signing secret remain in payment-method configuration. | Not run |
Cart integration
| Test | Input | Steps | Expected output | Result |
|---|---|---|---|---|
| BC-04: Open cart checkout | One item on copied Cornerstone cart page | 1. Select Bolt checkout. 2. Compare item and quantity. | Checkout opens for the current cart and sandbox division. | Not run |
| BC-05: Quantity refresh | Cart quantity changed from 1 to 2 | 1. Change quantity. 2. Wait for total update. 3. Open checkout. | Checkout quantity and total reflect the updated cart, with no stale price. | Not run |
| BC-06: Load failure | Block sandbox connect script in browser test tools | 1. Reload cart. 2. Inspect available checkout actions. 3. Restore script and reload. | Existing cart/checkout remains accessible; no false payment confirmation; Bolt action recovers after reload. | Not run |
Payment and order
| Test | Input | Steps | Expected output | Result |
|---|---|---|---|---|
| BC-08: Approved payment | Available product; approved Bolt Payments test card | 1. Pay once. 2. Find Bolt transaction. 3. Find store order. | One completed Bolt payment and one matching store order; item, quantity, shopper, amount and currency agree. | Not run |
| BC-09: Rejected payment | Pre-auth irreversibly rejected card from the Bolt Payments table, using the card set assigned to your division; fresh cart/link | 1. Submit the rejection card. 2. Inspect transaction and order state. | Payment is rejected before authorization; no order is marked paid; shopper can retry with a supported payment method. | Not run |
| BC-10: Cancel checkout | Unpaid cart/link | 1. Open checkout. 2. Close it before paying. 3. Return to the cart/link. | No completed payment; chosen product remains available for another attempt. | Not run |
| BC-11: Repeat submit | Fresh test purchase | 1. Submit twice quickly. 2. Reconcile resulting transactions and orders. | No duplicate completed purchase or duplicate paid order. | Not run |
| BC-12: Uncertain result | Fresh purchase; controlled connection interruption | 1. Interrupt the browser connection after submit. 2. Restore it. 3. Check Bolt and store before retrying. | Operator can determine the existing outcome; no blind second charge. A completed payment has a matching order. | Not run |
Experience you control
| Test | Input | Steps | Expected output | Result |
|---|---|---|---|---|
| BC-14: Phone and keyboard | Narrow phone and keyboard-only desktop | 1. Reach the checkout entry. 2. Open and close checkout. 3. Return to the entry. | Merchant-owned entry remains usable, visible and reachable; focus and return behavior do not strand the shopper. Report Bolt-owned checkout defects to Bolt. | Not run |
| BC-15: Totals | Known product price and supported address | 1. Record store pricing. 2. Enter shipping address. 3. Compare final breakdown. | Product, quantity, shipping, tax, currency and total agree with store configuration. | Not run |
Additional launch checks
| Test | Input | Steps | Expected output | Result |
|---|---|---|---|---|
| BC-13: Store identity | Configured logo and support contact | 1. Open checkout. 2. Inspect identity/support. 3. Inspect confirmation. | Correct store identity and contact details; confirmation refers to the purchased product/order. | Not run |
| BC-07: Other cart entries | Configured fast cart and mini cart extensions | 1. Apply template reference. 2. Open each entry. 3. Change cart contents and retry. | Every enabled storefront entry reflects its cart. This is outside the cart-page baseline. | Not run |
| BC-16: Refund reconciliation | Separate completed sandbox purchase; supported refund setup | 1. Follow the platform refund procedure. 2. Compare Bolt and store records. | Refund amount/status reconcile; no duplicate refund. Record unsupported behavior as a launch blocker, not a passed baseline case. | Not run |
| BC-17: Fulfillment | Separate paid order and configured fulfillment workflow | 1. Process the order in the store. 2. Check shopper-facing confirmation/tracking. | Only paid orders enter the intended fulfillment flow; merchant-owned messaging matches the order. | Not run |
| BC-18: Production configuration | Approved production account and separate launch checklist | 1. Review hosts/keys/account. 2. Run an approved production-readiness test. | No sandbox keys, links or scripts in production; launch evidence is recorded separately from sandbox acceptance. | Not run |