Skip to main content

Bold Booster for PayPal on Adobe Commerce

Bold Booster for PayPal is a Magento 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.

Setup​

To set up Bold Booster for PayPal, 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 and Adobe Commerce.

Configure firewall settings​

Many merchants have firewalls in place that restrict incoming and outgoing network traffic, allowing only a predefined set of IP addresses. The nature of a platform connector requires Bold to make calls to your server. 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:

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

  • https://api.boldcommerce.com
  • https://checkout.boldcommerce.com
  • https://adobe-commerce-connector.boldapps.net

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 onboarding​

  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. Adobe checkout section
  3. 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
  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 Booster for PayPal.
    3. Add and configure a payment gateway.
      1. Click Alternative payment gateways and select PPCP or Braintree.
      2. Connect your PayPal account to Bold.
      3. 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.
      4. Leave the Allow Bold Checkout to perform payments and refunds box checked.
      5. When prompted, click Allow to connect your store to your selected payment gateway.
      6. Follow the prompts to return to your store setup.
      7. Next to your selected payment gateway, click the ellipsis (...) to edit the settings.
        1. 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.

        2. (Optional, PPCP only) Choose your button shape and color.
        3. (Optional) Enable 3D Secure card payments. Do not enable this if you will also be using Fastlane.
      8. 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: Enter the API token​

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

    Scope dropdown screenshot
  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. Screenshot of configurations for payment booster
  5. For Is Payment Booster Enabled, uncheck Use Default and select Yes.
  6. Click the Save Config button at the top of the page.

Step 5: Activate the extension​

  1. In your Adobe Commerce admin, navigate to System > Integrations. Screenshot of integrations menu
  2. In the list of integrations, find BoldPlatformIntegration{websiteId}. Click Activate.
    note

    If you only have one website, the integration is called BoldPlatformIntegration1. The suffix number changes depending on the number of stores you choose to integrate with Bold Booster.

    Screenshot of integrations list
  3. When prompted to allow access to requested resources, click Allow. The extension authenticates and completes installation.
    caution

    If a failure message appears, do not click Reauthorize. Instead, delete the integration from the Integrations page in the Adobe admin, return to the Stores > Settings > Configuration page, and re-save the configuration.

Step 6: 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. Adobe 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. Adobe Scope Menu
  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. Is Fastlane Enabled dropdown menu
  12. In the top left, click Save Config.
  13. 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​

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.