Skip to main content

Install Bold Booster on Adobe Commerce (Magento 2)

Bold Booster is an extension that makes it easy for merchants to access a diverse lineup of payment solutions, including Fastlane (US only), Venmo (coming soon, US only), Pay Later, and other payment options customers prefer. Bold Booster seamlessly integrates with your existing checkout, so you can retain all your current customizations without any disruption or additional costs.

The following video walks through an example Bold Booster installation.

Overview

Setup​

To set up Bold Booster on your Adobe Commerce (formerly Magento 2) store, complete the following steps.

Step 1: Configure security settings​

Configure your security settings so Bold can communicate with your store.

Your store setup might have firewalls in place that restrict incoming and outgoing network traffic, allowing only a predefined set of IP addresses. For Bold's integrations to function, Bold domains must be able to make requests to your application. This means you must add specific domains or IP addresses to your allowlist.

  1. Add the following domains to your allowlist:
    • https://api.boldcommerce.com
    • https://checkout.boldcommerce.com
  2. Add the following IP addresses to your allowlist:
    • 34.118.185.130
    • 34.152.35.117
    • 35.234.253.95
    • 35.234.240.214
    • 34.152.62.195
    • 35.203.83.169
    • 34.95.4.134
    • 35.203.123.95
    • 35.203.41.15
    • 35.203.111.218
    • 35.203.12.94
    • 34.152.48.9
    • 35.203.70.90
    • 34.152.57.79
    • 34.152.40.169
    • 35.203.98.49
    • 35.234.243.147
    • 34.118.146.188
    • 34.152.1.134
    • 34.152.7.136
    • 35.234.248.107
    • 35.234.247.246
    • 35.203.50.156
    • 34.95.47.124
    • 35.203.8.162
    • 35.203.89.99
    • 35.203.5.164
    • 34.95.58.196
    • 35.203.82.91
    • 35.234.246.9
    • 35.203.57.139
    • 35.203.27.123
    • 34.152.60.211
    • 35.203.79.153
  3. If your security system filters traffic based on headers, add the User-Agent header with a value of Bold-API to your allowlist.

For more information about allowlisting and Bold's security configuration requirements, refer to the security concepts overview.

Step 2: Install Bold Booster​

Bold recommends installing using Composer for the easiest experience. However, you can also install the files manually.

  1. Open your terminal and navigate to your Adobe Commerce/Magento project directory.
  2. Run the following Composer command to install Bold Booster: 
    composer require bold-commerce/module-checkout-payment-booster
  3. Enable the extension using the following commands: 
    php bin/magento setup:di:compile
    php bin/magento setup:upgrade
  4. If you're using a 2.3.x version of Adobe Commerce, apply the following patch so Bold's content security policy (CSP) works correctly with your store: 
    patch < vendor/bold-commerce/module-checkout-payment-booster/patches/CSP-PAYMENT-BOOSTER_2.3.x.patch
    If you're not sure what Adobe Commerce version you have, follow Adobe Commerce's documentation to find out.

Step 3: Complete Bold Booster onboarding​

  1. In the Adobe Commerce admin, navigate to Stores > Configuration. Adobe Stores Configuration
  2. In the Scope drop-down menu at the top of the page, select the website where you're setting up Bold. This option is often called Main Website, but you might have renamed it to match your website name.
    note

    In Adobe Commerce versions earlier than 2.4, this drop-down is titled Store View.

  3. In the left-hand menu of the Configuration page, navigate to Sales > Checkout. Adobe checkout section
  4. A Bold Checkout onboarding banner appears on the page, prompting you to set up your store. Click the Connect with Bold button. Connect with Bold onboarding button
  5. A pop-up window appears. Follow the instructions in the window to create a Bold account if you haven't already.
    note

    Ensure that your browser does not have any settings enabled that block cookies, such as "Incognito Mode" or similar "Do Not Track" (DNT) settings. These settings can cause an error when attempting to complete this step.

  6. Connect your store. When entering your URL, remove the http:// or https:// and any trailing slash (/).
  7. Install Bold Checkout.
  8. On the Connect a payment gateway step, find a payment gateway you want to use and click Connect.
  9. Enter your payment gateway credentials. Refer to the following documentation for help setting up popular payment gateways with Bold Booster:
  10. Next to the payment gateway, click the ellipsis (...) and click Edit credentials to configure the gateway.
  11. (PayPal Complete Payments and Braintree) For Payment gateway name, specify a name for this gateway, or leave it as is. This name won't be visible to customers.
  12. For Currency, select the currency this gateway will use.
  13. (PayPal Complete Payments only) For PayPal account, confirm the email is the correct email associated with your PayPal business account.
  14. Under Payment Methods, select which payment method(s) you want this payment gateway to use. Refer to Connect payment gateways for details about which gateways support which payment methods.
  15. (Optional, PayPal Complete Payments only) Customize the appearance of the payment method buttons.
  16. Specify whether you want this gateway to use 3D Secure for card payments. Do not enable 3D Secure if you also enable Fastlane.
  17. Select whether you want to enable guest checkout using Fastlane by PayPal.
  18. Click Save.
  19. Repeat for each payment gateway you want to connect.
  20. Copy the API access token.
    caution

    Ensure that you save the API access token in a safe place. You will need it for the next step.

  21. Click Close.

Step 4: Configure in the Adobe Commerce admin​

  1. If you are not already there, navigate to the Stores > Configuration page in the Adobe Commerce admin.
  2. In the left-hand menu of the Configuration page, navigate to Sales > Checkout. Adobe checkout section
  3. In the Scope drop-down menu at the top of the page, select the website where you're setting up Bold. This option is often called Main Website, but you might have renamed it to match your website name.
    note

    In Adobe Commerce versions earlier than 2.4, this drop-down is titled Store View.

    Scope dropdown screenshot
  4. Expand the Bold Checkout Payment Booster Extension section.
  5. In the API Token field, enter the API access token you copied.
  6. For Configuration Group Label, use this table to determine which action to take.
    ConfigurationWhat to do
    Your store domain in Bold Account Center is the same as your Magento base URL.Leave Configuration Group Label as is. It's OK if this field is blank.
    Your store domain in Bold Account Center is different from your Magento base URL.Edit Configuration Group Label to exactly match your Bold Account Center store domain. Ensure the domain does not include the protocol (such as https://).
  7. For Is Payment Booster Enabled, uncheck Use Default and select Yes.
  8. For Is Fastlane Enabled, select whether you want to enable Fastlane. Refer to the enable Fastlane section for details.
  9. (Optional) For Payment Title, specify a title for the section of your checkout that accepts credit card payments.
  10. (Optional) For Digital Wallets Title, specify a title for the section of your checkout that accepts digital wallet payments such as Apple Pay or Google Pay.
  11. For the Enable Digital Wallets in Express Checkout drop-down, if you want payment options to appear above the shipping step, select Yes. Otherwise, select No.
    note

    If your checkout has mandatory checkboxes after the payment step, such as terms and conditions or a GDPR confirmation, you must select No.

  12. (Optional, PayPal Complete Payments only) To further streamline checkout, enable digital wallets (such as PayPal, Apple Pay, or Google Pay) on the cart or product pages.
    • Enable Digital Wallets on Cart Page: If you select Yes, additional payment buttons will appear on the cart page and in the mini cart, separate from your existing checkout button.
    • Enable Digital Wallets on Product Pages: If you select Yes, payment buttons will display directly on all product detail pages.
  13. Click the Save Config button at the top of the page.
  14. Navigate to System > Cache Management and click the Flush Magento Cache button.

Step 5: Enable Fastlane (optional)​

Fastlane by PayPal offers a streamlined checkout experience to existing Fastlane customers and allows new customers to quickly and easily save their payment and shipping information for a seamless checkout experience in the future. Customers can use Fastlane wherever it's available on the internet, allowing you to leverage a network of millions of PayPal customers.

Install and configure Fastlane with Bold Booster to reduce steps in checkout, boosting conversions and increasing lifetime customer value.

Requirements​

  • An Adobe Commerce or Magento Open Source store located in the United States, selling in USD.
  • A PayPal Complete Payments or Braintree Credit Card payment gateway.
    • Fastlane does not currently support 3D Secure.
  • Fastlane enabled in your PayPal account. Refer to PayPal's documentation for enabling Fastlane with PayPal Complete Payments or Braintree.

Enable Fastlane in Bold Account Center​

If you already enabled Fastlane during onboarding, skip to configuring Fastlane.

  1. Log in to Bold Account Center and open Bold Checkout.
  2. Navigate to Payment options > Payment gateways.
  3. Next to PayPal Complete Payments or Braintree, click on the ellipsis (...) to edit the settings.
  4. Check the box to enable Fastlane by PayPal.
  5. (Optional) Click Style Fastlane to access the Advanced Style Settings.
  6. Click Save.

Next, configure Fastlane in the Adobe Commerce admin.

Configure Fastlane in the Adobe Commerce admin​

After you've enabled Fastlane in the Bold Account Center, finish the process by configuring it to work with your store.

  1. In the Adobe Commerce admin, navigate to Stores > Configuration. Adobe Stores Configuration
  2. In the left-hand menu of the Configuration page, navigate to Sales > Checkout.
  3. If you have multiple websites, find the Scope drop-down menu at the top of the page, and select the website you want to configure. Adobe Scope Menu
  4. Under Bold Payment Booster Extension, for Is Payment Booster Enabled, uncheck Use Default and select Yes if you haven't already. A Fastlane field appears.
  5. For Is Fastlane Enabled, uncheck Use Default and select Yes. Is Fastlane Enabled dropdown menu
  6. For Enable Express Pay, ensure you have selected Yes. This is required for Fastlane to work correctly.
  7. In the top left, click Save Config.
  8. Navigate to System > Cache Management, and click the Flush Magento Cache button.
Walkthrough

Customer experience: Existing PayPal customer with a Fastlane profile

When the customer enters a PayPal associated email in the checkout, they receive a verification code by text which they can then enter into the checkout. Once validated, the checkout is automatically populated with their saved shipping, billing, and payment information. From here, they can either complete the order, or they can adjust their checkout information.

Existing customer screenshot

Customer experience: Customer without a Fastlane profile or PayPal-associated email address

When the customer proceeds to the checkout, they enter their email address, shipping information, and payment information as usual. If the customer consents to save their payment profile with Fastlane (enabled by default) on the payment information page, a Fastlane profile is automatically created once they complete their order. Customers can also manually disable Fastlane account consent if they do not wish to save a Fastlane profile.

note

Fastlane opt-in is only displayed to customers located in the United States.

Existing customer screenshot

Next steps​

After installing Bold Booster on your store, you can:

If you need help onboarding, please submit a support ticket. Or, if you have a Bold representative working with you, add them as a support user on your store and contact them for further help.