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.
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:
- Domains
- 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
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
- In your store's directory, navigate to the
app/code/community
location. - Create a new folder titled
Bold
. - In the newly created Bold directory, create a new folder titled
CheckoutPaymentBooster
. - 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).
- Unzip the downloaded directory.
- 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. - 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
- Clear your Magento Admin cache.
- Navigate to System > Cache Management.
- Click the Flush Magento Cache button.
- Click the Flush Cache Storage button, then click OK on the confirmation pop-up message.
- Navigate to System > Configuration.
- In the Sales section of the left-hand menu, click Checkout.
- In the Current Configuration Scope drop-down menu, select Main Website.
- 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.
- A pop-up window appears. Follow the instructions in the window to complete the following steps:
- Create a Bold account and connect your store.
- Install Bold Checkout.
- Add and configure a payment gateway.
- Click Alternative payment gateways and select PayPal Complete Payments or Braintree.
- If you want to only use PayPal payment buttons, uncheck the Use advanced credit and debit card fields box.
- Check the box to Allow Bold Checkout to perform payments and refunds.
- Click Connect to connect your store to your selected payment gateway.
- Enter your PayPal or Braintree credentials.
- Follow the prompts to return to your store setup.
- Next to your selected payment gateway, click the ellipsis (...) and click Edit credentials.
- 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.
- (Optional, PPCP only) Choose your button shape and color.
- (Optional) Enable 3D Secure card payments. Do not enable this if you will also be using Fastlane.
- (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.
- PPCP, Braintree, or Stripe payment gateways: Ensure you're hosting the domain association file in the correct location.
- 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.
- (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.
- Click Save.
- 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
- If you are not already there, navigate to the System > Configuration page in the Magento admin.
- In the left-hand menu of the Configuration page, navigate to Sales > Checkout.
- In the Current Configuration Scope drop-down menu at the top of the page, select Main Website.
- Expand the Bold Checkout Payment Booster Extension section.
- For the Enabled Payment Booster drop-down, select Yes.
- 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.
- Populate the API Token field using the API access token you copied during onboarding.
- (Optional) To customize styling, expand Bold Checkout Payment Booster Advanced Settings.
- (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 replaceBold Payments
orCredit Card
with your preferred title. - 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.
- Log in to Bold Account Center and open Bold Checkout.
- Navigate to Payment options > Payment gateways.
- Next to PayPal Complete Payments or Braintree, click on the ellipsis to edit the settings.
- Check the box to enable Fastlane by PayPal.
- (Optional) Click Style Fastlane to edit additional style settings.
- Click Save.
- In the Magento admin, navigate to System > Configuration.
- In the left-hand menu of the Configuration page, navigate to Sales > Checkout.
- In the Current Configuration Scope drop-down menu, select Main Website.
- Under Bold Checkout Payment Booster Extension, for Enabled Payment Booster, select Yes if you haven't already. A Fastlane field appears.
- For Enabled PayPal Fastlane, select Yes.
- For Enable Express Pay, ensure you have selected Yes. This is required for Fastlane to work correctly.
- Click Save Config.
- 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.
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.
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.