Bolt Developer

Welcome to the Bolt developer hub. You'll find comprehensive guides and documentation to help you start working with Bolt as quickly as possible, as well as support if you get stuck. Let's jump right in!

Integration Testing Checklist

1. Basic Checkout

1a. Add items to the cart and click on the Bolt Checkout Button

  • The Bolt modal should load and show the checkout form
  • Clicking the cart logo shown in the top right corner must display the shopping cart
  • All the items in the cart must also be present in the Bolt cart
  • The cart total must exactly match the cart total (to the cent)

1b. Enter a valid shipping address and click Continue

  • You should see all the shipping options available for that address
  • Click dropdown on top right on Bolt modal. You should see accurate tax amount based on selected shipping option

1c. Select a shipping option + click next + complete checkout and click "Pay" to submit payment

  • There should be a success modal and you are automatically redirected to order confirmation page (Check to make sure the styling is correct)
  • [email] You should receive an order confirmation email from Bolt
  • [email] The cart details in the order confirmation email must match the actual cart items
  • [email] The total in the confirmation email must match the actual cart items
  • [apihook] You should receive a hook notification for the order
  • [apihook] The hook notification is successfully processed and the order is put in an appropriate state
  • An order is successfully created on your e-commerce store
  • The order contains the same shipping address that was entered
  • The order contains the selected shipping option
  • The shipping cost and taxes are accurate in your system

2. Transaction Review and Approval

2a. Wait for 2-3 minutes for the transaction to be Approved by Bolt

  • [apihook] You should receive a hook notification for the order of type "auth" or "payment" based on whether autocapture is enabled or not
  • [apihook] The hook notification is successfully processed and your order is put in "processed" or something equivalent

3. Refund

3a. Issue refund from Bolt merchant dashboard

  • [apihook] The hook notification is successfully update the status in your server to refunded status
  • Order is refunded in the merchant dashboar#d

4. Cart Update

4a. "Navigate to cart page. Open Bolt modal. Change quantity of item in cart. Open modal and confirm checkout is updated"

  • User is shown the updated total as well as the additional items in the bolt modal

5. Free Shipping

5a. Add items that add to free shipping amount + Enter shipping address + Click next

  • User is given the option for free shipping

6. Discount Codes

6a. Add items to the cart (with at least 1 item with quantity > 2) + add a discount code + click on Bolt's blue checkout button

  • The Bolt modal should load and show the checkout form
  • Clicking the cart logo shown in the top right corner must display the shopping cart
  • All the items in the cart must also be present in the Bolt
  • The cart total must exactly match the cart total (to the cent)
  • The total tax amount in Bolt cart must match that in your cart
  • The discount codes should all be accounted for in the cart and must be reflected in the total

6b. Enter shipping address + Click next

  • You should see all the shipping options available for that address

7. Mobile

7a. Hit command+option+i to open the developer tools + select Toggle device toolbar + select Pixel 2 or iOS device

  • "User should see Bolt button on checkout. No rendering issues on Bolt Checkout process."

7b. Add items to the cart (with at least 1 item with quantity > 2) + click on the Bolt Checkout Button

  • The Bolt modal should load and show the checkout form
  • Clicking the cart logo shown in the top right corner must display the shopping cart
  • All the items in the cart must also be present in the Bolt cart
  • The cart total must exactly match the cart total (to the cent)

Integration Testing Checklist


Suggested Edits are limited on API Reference Pages

You can only suggest edits to Markdown body content, but not to the API spec.