📍 Bolt / Developers / Developer References / Pre-Authorization Sequence

Pre-Authorization Sequence

Pre-authorization is a redesigned sequence that changes how Bolt works with cart and card authorizations. When a shopper select the Pay button in Bolt Checkout, there are two events which must happen for a successful order to occur.

Required Checkout Events
  • Credit Card Authorization
  • Order Creation in the Shopping Cart

Classic vs Pre-Authorization Sequences

Classic Sequence

In the classic sequence the credit card authorization occurs first. If the card is successfully authorized, the order is created in the shopping cart. Occasionally, the order creation is not possible, and then it will be rejected by the shopping cart.

The failure to create an order can be due to a variety of reasons, including:

  • A selected product is out-of-inventory.
  • An invalid shipping address was used.
  • An expired/invalid discount code was used.

When a failure occurs, it can result in failed webhooks, and will generally require manual steps to resolve the issue. This often involves merchant assistance.

Pre-Auth Sequence

In the pre-auth sequence, the order creation occurs first. This prevents the failed cart issue previously above and also reduces the chance of webhooks failures.

Reasons to Use the Pre-Authorization Sequence
  • Eliminates inventory errors
  • Enables real-time order processing to better match sales timelines
  • Improves customer messaging

Order Statuses

See your eCommerce platform’s overview article for a list of order statuses.

Examples of Pre-Auth Sequence

The two charts below each walkthrough a typical sequence with Pre-Auth. The walkthroughs go from when the shopper selects the Pay button, through the payment capture, and terminate with the final response to the customer.




How did we do?

📖On This Page