Skip to main content

Bold Booster for PayPal

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), Buy Now Pay Later, and other payment options preferred by customers. Bold Booster for PayPal seamlessly integrates with any existing Magento checkout, allowing you to retain all your current customizations without any disruption and at no additional cost.

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. Configuration menu screenshot
  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.
    2. Install Bold Booster.
    3. Add and configure a payment gateway:
      1. Click Alternative payment gateways and select PPCP or Braintree.
      2. Connect your PayPal account to Bold.
    4. Click Return to Bold Innovation Group Ltd. to continue setup.
    5. Click the ellipsis next to the PPCP or Braintree payment gateway you just added.
    6. (Optional) If you plan to enable Fastlane, complete the following steps.
      1. Click Edit credentials.
      2. Scroll down to the Fastlane by PayPal section and check the box to enable Fastlane.
      3. Click Save and Continue.
    7. In the API access token field, click Copy.
    8. Create an 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. Configuration menu screenshot
  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. Screenshot of configurations for payment booster
    1. In the API Token field, uncheck the Use Default box.
    2. Enter the API access token you copied.
  5. 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.

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

Customers can use Fastlane wherever it's available on the internet, allowing you to leverage a network of millions of PayPal customers.

Alert

Fastlane is currently available for Adobe Commerce and Magento Open Source stores only. Join the waitlist for Magento 1 support.

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. 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 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. Adobe Scope Menu
  4. Under Bold Checkout Extension, for Enable Bold Checkout, uncheck Use Default and select Yes.
  5. Under Bold Payment Booster Extension, for Is Payment Booster Enabled, uncheck Use Default and select Yes. A Fastlane field appears.
  6. For Is Fastlane Enabled, uncheck Use Default and select Yes. Is Fastlane Enabled dropdown menu
  7. In the top left, click Save Config.
  8. Navigate to System > Cache Management, and click the Flush Magento Cache button.
    note

    If you are using Braintree Credit Card as your payment gateway, Bold recommends adding the PayPal Express payment gateway as well. This gives your customers the option to use PayPal in Bold's express checkout section before moving to Fastlane.

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.