1. Set Up Quick Checkout
Learn how to integrate Bolt's Quick Checkout for Adobe (Magento) Commerce.

Before You Start

Review the following requirements before installing Quick Checkout on your Adobe Commerce store:

Requirements Constraints
PHP version Depending on the Adobe Commerce instance version >=2.4.4
Composer Depending on the Adobe Commerce instance version >=2.4.4
Magento Open Source or Adobe Commerce >=2.4.4 none


Use Adobe’s official installation steps to add the Quick Checkout extension to your store.


  1. Log into Adobe Commerce admin. This is typically located at yourstoreurl.com/admin.
  2. Navigate to Stores > Configuration > Sales > Checkout.
  3. Scroll to Quick Checkout.
  4. In a separate browser tab, create a Production or Sandbox merchant account with Bolt. Provide all of the following required information:
    • First Name
    • Last Name
    • Email Address
    • Store Name
    • Website URL
    • Payment Processor
  5. Set up your chosen payment processor from the Bolt Merchant Dashboard:


Click to expand.


Click to expand.


Click to expand.


Click to expand.


Click to expand.


Click to expand.

  1. Obtain the following API keys by navigating to Developers > API > Keys in the Bolt Merchant Dashboard.

    • API Key: A private key used by your backend to interact with Bolt’s APIs.
    • Publishable Key: A key used by your front-end to interact with Bolt’s APIs. Publishable Key: A key used by your front-end to interact with Bolt’s APIs. The publishable key is a long string of lower and upper case letters and numbers that consists of three sections. publishable key
    • Signing Secret: Used for signature verification on requests received from Bolt.
  2. In the Adobe Commerce browser tab, scroll to Account Credentials

  3. Insert the unique API Key, Publishable Key, and Signing Secret.

  4. Define your Service Settings.

    • Title: Used to identify Bolt payment options displayed in your storefront (e.g., Credit Card powered by Bolt).
    • Payment Action: Determines whether transaction capture is automatic upon authorization (Authorize and Capture) or delayed (Authorize).
    • Debug Mode: Used to test and troubleshoot the Quick Checkout experience.
  5. Set Environment dropdown to match Sandbox or Production, depending on which onboarding flow you used.

  6. Set Enable dropdown to Yes to activate the extension.

  7. Select the Save Config button.

Automatic Login

You can enable shoppers to be automatically logged into Bolt at checkout.

  1. In the Adobe Admin sidebar, navigate to Stores > Configuration > Checkout to access the Checkout Admin settings.
  2. Below Service Settings > Automatic Login Enabled click Yes.


The Bolt OTP pop-up only appears when the shopper is on the checkout page. The shopper can opt out from logging into Bolt by closing that pop-up window.


Review the following limitations of the Quick Checkout beta:

General Limitations

Limitations Constraints
US only This feature is only available for US merchants
USD only USD is the only compatible currency
Amazon Pay Quick Checkout is not compatible with Amazon Pay
PWA Studio and headless deployments Merchants MUST use the Luma-based coupled storefront. PWA Studio and headless deployments are not supported
3D Secure 3D Secure is not supported
B2B B2B is not supported
ISPU In-Store Pickup (ISPU) functionality is not supported
Multishipping Multishipping is not supported

Transaction Limitations

Review which advanced transaction actions are supported for your processor.

Advanced Transaction Actions Bolt Payments Stripe Adyen Braintree CyberSource NMI Auth.net
Multi Partial Refund ✅ Post Capture
Refund After Capture
Void After Partial Capture
Refund After Partial Void
Void After Full Capture
L2/L3 Data Support
Webhooks ✅ Capture/Void/Refund ✅ Polling for Capture/Void; delayed 1 hour

Transaction Processing Considerations

In the event a given transaction action is not supported for your processor on the previous table, you may consider these alternative solutions:


If multi-capture is not supported for your processor, it is important to understand that after the initial capture, the authorization can no longer be used for additional captures. The most straightforward solution is using the Authorize and Capture Payment Action setting, which will ensure that only one capture is being made against the order. In case this is not an acceptable solution and you must set your Payment Action to Authorize, we recommend one of the following:

  • Shipping the whole order together and then capturing the full amount
  • Creating a full invoice before the first shipment happens to avoid un-invoiced shipped items

Void After Partial Capture

Refund After Capture

If you need access to initiating refunds during the majority of a transactions lifecycle, we recommend using the Payment Action setting of Authorize and Capture. In the event a refund fails due to a capture still being unconfirmed, the platform notifies the user that it’s not possible to perform the refund yet. Make sure to inform your customer service representatives that they may encounter this and to wait until the transaction’s status updates before re-initiating the refund.

Orders processed via Authorize.net can be voided when in the captured-but-not-settled state.

Refund After Partial Void

Adobe Commerce does not allow partial void.


You can view and pay your Bolt invoice from the merchant dashboard. See Billing for details.


To update the Adobe Quick Checkout extension, visit Adobe’s documentation.

Filter by Section
Filter by Topic