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!

Get Started    Docs

WooCommerce Operations

Order Review and Statuses

When a user places an order, its initial order status will be Pending payment (See #19472 below), which indicates Bolt is reviewing the order. There are four potential statuses the order may take after review:

Bolt Rejected

When Bolt suspects the transaction is likely a fraud, Bolt rejects the transaction. In this case, the status will be updated “Bolt Rejected” (#19471). You may either “force approve” or “confirm rejection” in the Bolt Merchant Dashboard.


When Bolt is confident an order is fraud, Bolt irreversibly rejects the transaction. In this case, the status will be updated to “Failed” (#19470)


When Bolt approves the order, the status will be updated to "Processing" (#19469). If “auto capture” is enabled, payment is captured at this point. Otherwise, the payment will be captured when the invoice is issued.

On Hold

If Auth&Capture is set for the merchant (funds are captured separately from the authorization), then an order will be placed "On Hold" once it has been authorized. This indicates the merchant can fulfill the order, and once updated to "Processing" in WooCommerce Bolt will capture the funds.

WooCommerce Admin Dashboard

WooCommerce Admin Dashboard

Bolt Merchant Dashboard

Bolt Merchant Dashboard

Taking Phone Orders

Creating an Order

To create a new order in the WordPress Admin Dashboard, navigate to the WooCommerce Orders page and select "Add order."

  1. Enter the address, items, and shipping information
  2. Select Bolt as the payment method
  3. Keep status as "Pending payment"
  4. Click "create" to save the order

Email invoice

Once the order has been created, you can send choose to send an email invoice to the customer.

The customer will receive a link that they can use to complete the payment with Bolt.

Pay using Bolt Dashboard

Alternatively, if you'd prefer to take the customer's payment information over the phone, open the Bolt merchant dashboard by clicking "Bolt dashboard to process payment" and select "New Payment." (Orders created using the Bolt virtual terminal will not be indemnified)


Refunds are best processed as issuing a refund through WooCommerce, as the Bolt Merchant Dashboard will not automatically sync with your order management system.
See more information in our support site article: Issue a Refund
For details on WooCommerce refunds go here.

WooCommerce Operations

Suggested Edits are limited on API Reference Pages

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