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!

Magento 2 Operations

Order Review and Status Changes

As Bolt processes the order, it will transition through several different statuses:

Magento Status
Description

Payment Review

When a user places an order, its initial order status will be "Payment Review" (See below #000000095). The order remains in this status until it is approved or rejected.

Processing

When Bolt approves the order, the status will be updated to "Processing" (#000000092). If you enable “auto capture”, payment is captured at this point. Otherwise, the payment will be captured when you issue an invoice.

On Hold

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

Cancelled

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

Bolt Merchant Dasboard

Bolt Merchant Dasboard

Magento 2 Admin Panel

Magento 2 Admin Panel

Transaction Void and Payment Refund

When an authorized transaction is canceled (voided) from the store admin the order is put in "Cancelled" state.

After a refund (Credit Memo) is issued the order status gets set to one of the following:

  • Complete - if the payment was partially refunded
  • Closed - for completely refunded order payments

Bolt Payment Processing for Manually-Created Orders

Merchants can use Bolt to process payments for orders manually created in the Magento 2 dashboard.

One-Time Set-Up: Configure the Magento 2 Backend

  • Request a publishable key from your Bolt Account Manager. Please note manual orders are not indemnified fraud.
  • In your Magento configurations, look for Bolt Pay. Enter your key into Publishable Key - Back Office.
  • Once saved, Bolt will be available as a payment method in manual order creation.

Create an Order

  • On your Orders page, select Create New Order in the top right.
  • Under Payment Method, click on Continue to Payment under the Bolt Pay radio button.
  • This will bring up Bolt Checkout. You can now enter the information and click Pay to complete the payment.
  • Complete the rest of the form and Submit Order to process the order. Once you hit submit, you're all set: the information will automatically be sent to and processed by Bolt.

How to issue a refund (create a Credit Memo )

Step 1: Click "View" action on the invoice row in Order Invoices section

Step 1: Click "View" action on the invoice row in Order Invoices section

Step 2: Click "Credit Memo" on the invoice page

Step 2: Click "Credit Memo" on the invoice page

Step 3: Click "Refund" at the bottom of the New Memo page

Step 3: Click "Refund" at the bottom of the New Memo page

Newly created Credit Memo appears in the Credit Memos section. Click "View" action to display it.

Newly created Credit Memo appears in the Credit Memos section. Click "View" action to display it.

Credit Memo details page

Credit Memo details page

Payment and Refund transactions as shown in Bolt merchant dashboard transaction panel

Payment and Refund transactions as shown in Bolt merchant dashboard transaction panel

Bolt Merchant Dashboard transaction details

Bolt Merchant Dashboard transaction details

Magento 2 Operations


Suggested Edits are limited on API Reference Pages

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