Install Bold Booster for PayPal on Adobe Commerce

Bold Booster for PayPal is an extension that makes it easy for merchants to get access to PayPal’s full lineup of payment solutions, including Fastlane (US only), Venmo (coming soon, US only), Buy Now Pay Later, and other payment options preferred by customers. Bold Booster for PayPal seamlessly integrates with your existing checkout, allowing you to retain all your current customizations without any disruption and at no additional cost.

note

Contact us to get free white-glove installation and up to $500 back in transaction fees.

Prerequisite

If you plan on using Apple Pay with PPCP, Braintree, or Stripe, download the domain association file for your sandbox environment and host it at /.well-known/apple-developer-merchantid-domain-association.

Refer to the following developer documentation for more details depending on your payment gateway:

• PPCP
• Braintree
• Stripe

Setup

To set up Bold Booster for PayPal on your Adobe Commerce store, complete the following steps.

Step 1: Configure security settings

Your store's security settings, usually for local or test instances, may prevent Bold from making calls to your store. Use the following sections to ensure Bold can communicate properly and securely with your store.

Configure firewall settings

Many merchants 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.

To ensure proper operation, you must configure your firewall settings to allow requests from the following domains or IP addresses:

Domains

Calls from Bold come from one of the following domains and may be GET, PUT, or POST requests:

• https://api.boldcommerce.com
• https://checkout.boldcommerce.com

IP Addresses

Calls from Bold to your platform connector come from the following IPs:

• 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.15

Configure User-Agent settings

Each call from Bold to your store is accompanied by a User-Agent header with a value of Bold-API. If your security system filters traffic based on headers, ensure that calls marked with User-Agent=Bold-API are permitted.

Step 2: Install Bold Booster for PayPal

1. Open your terminal and navigate to your Adobe Commerce/Magento project directory.
2. Run the following Composer command to install Bold Booster for PayPal:

   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

Step 3: Complete Bold Booster for PayPal onboarding

1. In the Adobe Commerce admin, navigate to Stores > Configuration.
2. In the left-hand menu of the Configuration page, navigate to Sales > Checkout.
3. A Bold Checkout onboarding banner appears on the page, prompting you to set up your store. Click the Connect with Bold button.
4. A pop-up window appears. Follow the instructions in the window to complete the following steps:
   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.

   1. Create a Bold account and connect your store.
   2. Install Bold Checkout.
   3. Add and configure a payment gateway.
      1. Click Alternative payment gateways and select PayPal Complete Payments or Braintree.
      2. If you want to only use PayPal payment buttons with no additional credit card options, uncheck the Use advanced credit and debit card fields box.
      3. Check the box to Allow Bold Checkout to perform payments and refunds.
      4. Click Connect to connect your store to your selected payment gateway.
      5. Follow the prompts to return to your store setup.
      6. Next to your selected payment gateway, click the ellipsis (...) and click Edit credentials.
      7. Select your currency and payment types.
         note

         If you select a payment type that is not available to your region, that payment type will not appear on your storefront.

      8. (Optional, PPCP only) Choose your button shape and color.
      9. (Optional) Enable 3D Secure card payments. Do not enable this if you will also be using Fastlane.
      10. (Optional) Check the box for Apple Pay if you want customers to have this option at checkout. Complete these additional steps so Apple Pay works correctly.
          1. PPCP, Braintree, or Stripe payment gateways: Ensure you're hosting the domain association file in the correct location.
          2. PPCP: Enable Apple Pay in your PayPal account and set the phone number field to Required in your Adobe Commerce, Bold Checkout, and PayPal admin settings. Refer to the Bold Help Center for more details.
      11. (Optional) Check the box for Google Pay if you want customers to have this option at checkout.
          note

          If you enable Google Pay with Braintree, you also need to enable it in your Braintree business account settings.

      12. Click Save.
   4. 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.

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.
3. If you have multiple websites, find the Scope drop-down menu at the top of the page, and select the website you would like to configure. Skip this step if you are in Single Store Mode.
   note

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

   
4. Expand the Bold Checkout Payment Booster section to enter your API access token.
   1. In the API Token field, uncheck the Use Default box.
   2. Enter the API access token you copied.
5. For Configuration Group Label, use this table to determine which action to take.

   Configuration	What 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://).

6. For Is Payment Booster Enabled, uncheck Use Default and select Yes.
7. For Enable Express Pay, if you want payment options to appear above the shipping step, uncheck Use Default and 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 can't use Express Pay and must select No.

8. Click the Save Config button at the top of the page.

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 for PayPal to reduce steps in checkout, boosting conversions and increasing lifetime customer value.

Fastlane requirements

• An Adobe Commerce or Magento Open Source store located in the United States, selling in USD.
• A PayPal Complete Payments (PPCP) 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 PPCP or Braintree.

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.
7. In the Adobe Commerce admin, navigate to Stores > Configuration.
8. In the left-hand menu of the Configuration page, navigate to Sales > Checkout.
9. If you have multiple websites, find the Scope drop-down menu at the top of the page, and select the website you would like to configure. Skip this step if you are in Single Store Mode.
10. 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.
11. For Is Fastlane Enabled, uncheck Use Default and select Yes.
12. For Enable Express Pay, ensure you have selected Yes. This is required for Fastlane to work correctly.
13. In the top left, click Save Config.
14. 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.

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.

Next steps

If you have any issues with your 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.

You can update your payment gateway settings at any time in Bold Checkout under Payment options > Payment gateways.

Refer to Bold's additional documentation for help with upgrading and troubleshooting.