Skip to main content

Install Bold Booster for PayPal on Magento 1

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:

Setup

To set up Bold Booster for PayPal on your Magento 1 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:

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

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. In your store's directory, navigate to the app/code/community location.
  2. Create a new folder titled Bold.
  3. In the newly created Bold directory, create a new folder titled CheckoutPaymentBooster.
  4. Navigate to the Bold Checkout Payment Booster on Magento 1 repository. Download the repository contents (click the Code drop-down menu and select Download ZIP).
  5. Unzip the downloaded directory.
  6. Copy the contents of the unzipped directory to the app/code/community/Bold/CheckoutPaymentBooster location in your store's directory that you created in Step 2.
  7. Navigate to the root directory (the parent directory of /app) and execute the following commands:
   cp app/code/community/Bold/CheckoutPaymentBooster/etc/modules/Bold_CheckoutPaymentBooster.xml app/etc/modules/
cp -r app/code/community/Bold/CheckoutPaymentBooster/design/* app/design/
cp -r ./app/code/community/Bold/CheckoutPaymentBooster/skin/* ./skin/

Step 3: Complete Bold Booster for PayPal onboarding

  1. Clear your Magento Admin cache.
    1. Navigate to System > Cache Management. A screenshot of the Cache Storage Management page in the Magento Admin Panel
    2. Click the Flush Magento Cache button.
    3. Click the Flush Cache Storage button, then click OK on the confirmation pop-up message.
  2. Navigate to System > Configuration.
  3. In the Sales section of the left-hand menu, click Checkout.
  4. In the Current Configuration Scope drop-down menu, select Main Website. Screenshot of configuration scope dropdown
  5. A Bold Checkout onboarding banner appears on the page, prompting you to set up your store. Click the Connect with Bold button.
    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 onboarding.

  6. A pop-up window appears. Follow the instructions in the window to complete the following steps:
    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, 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. Enter your PayPal or Braintree credentials.
      6. Follow the prompts to return to your store setup.
      7. Next to your selected payment gateway, click the ellipsis (...) and click Edit credentials.
      8. 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.

      9. (Optional, PPCP only) Choose your button shape and color.
      10. (Optional) Enable 3D Secure card payments. Do not enable this if you will also be using Fastlane.
      11. (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.
      12. (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.

      13. 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 Magento 1 admin

  1. If you are not already there, navigate to the System > Configuration page in the Magento admin.
  2. In the left-hand menu of the Configuration page, navigate to Sales > Checkout.
  3. In the Current Configuration Scope drop-down menu at the top of the page, select Main Website.
  4. Expand the Bold Checkout Payment Booster Extension section.
  5. For the Enabled Payment Booster drop-down, select Yes.
  6. 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.

  7. Populate the API Token field using the API access token you copied during onboarding.
  8. (Optional) To customize styling, expand Bold Checkout Payment Booster Advanced Settings.
  9. (Optional) If you want to edit the Payment Method title, open etc/config.xml. Find the <title> tag on lines 145, 150, or both, and replace Bold Payments or Credit Card with your preferred title.
  10. Click the Save Config button in the top right.

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

  • A store located in the United States, selling in USD, on one of the following platforms:
    • Adobe Commerce
    • Magento Open Source
    • Magento 1
    • OpenCart
    • Gravity Forms
  • 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 edit additional style settings.
  6. Click Save.
  7. In the Magento admin, navigate to System > Configuration.
  8. In the left-hand menu of the Configuration page, navigate to Sales > Checkout. M1 Sales Checkout
  9. In the Current Configuration Scope drop-down menu, select Main Website. M1 Scope Menu
  10. Under Bold Checkout Payment Booster Extension, for Enabled Payment Booster, select Yes if you haven't already. A Fastlane field appears.
  11. For Enabled PayPal Fastlane, select Yes.
  12. For Enable Express Pay, ensure you have selected Yes. This is required for Fastlane to work correctly.
  13. Click Save Config.
  14. Navigate to System > Cache Management and click Flush Magento Cache.

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.

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.