Troubleshooting

This page includes instructions for addressing common issues and errors when installing the Bold Checkout extension on Adobe Commerce.

If you are experiencing issues that cannot be resolved by solutions on this page, reach out to Bold's Customer Success team and add the Bold representative that is working with you as a support user on your store. Provide your store URL and the issue you are experiencing. In some cases, providing your Adobe Commerce admin credentials can help Bold troubleshoot your errors.

Configuration issues

500 error

Problem

After installing Bold, refreshing a store's frontend returns a 500 error.

Troubleshooting

Follow these steps to disable any unused PPCP modules, Braintree modules, or other unused modules that cause the Content-Security-Policy-Report-Only header to become too large.

1. Using Chrome, open the developer tools and switch to the Network tab.
2. In the top left of the tab, clear the network log.
3. Navigate to your store's homepage and select the first entry in the Network tab. This will likely be the domain name.
4. Click the Headers tab and review the list to identify any unused modules that might be adding unnecessary headers.
5. In Magento, disable the unused modules. Refer to Adobe Commerce documentation for details.

Onboarding experience error

Problem

When you attempt to complete the Bold Checkout onboarding and reach the payment gateway step, you might get an error that states you are not logged in anymore. This error is shown in the following screenshot:

Troubleshooting:

Ensure that your browser does not have any settings enabled that block cookies, such as "Incognito Mode" or similar "Do Not Track" (DNT) settings.

Unexpected error

Problem:

When you attempt to configure the Bold Checkout Extension, you could get an unexpected error, shown in the following screenshot.

Troubleshooting:

To resolve this issue, ensure that the API access token that you are using is the appropriate one for your store. Each store should have a separate API access token obtained from Bold Account Center. You cannot use the same API access token for multiple stores.

Authorization issues

Authorization error messages

Problem:

The following errors can occur when you attempt to authorize the Bold Checkout extension in the Adobe Commerce admin:

• Failed to acquire access token. Please close this window and try again.
• Consumer key corrupt. Please recreate the integration and try again.
• An unknown error occurred. Please close this window and try again.
• Bold Adobe Commerce Modules not installed or may not be enabled. Please install/enable the Bold Adobe Commerce Modules and try again.
• Could not find shop. Ensure that the Platform Connector for Adobe Commerce is installed.

The following screenshot shows an example of such an error:

Troubleshooting:

To resolve authorization issues, try the following troubleshooting steps:

1. Your firewall may be blocking Bold's API calls. Ensure that your store's security settings are configured to accept calls from Bold. For detailed instructions, expand the following section:
   Details

   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:

   Domains

   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

   IP Addresses

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

   • 34.118.185.130
   • 34.152.35.117

   If you are using Bold Booster for PayPal, calls will also come from these additional IPs:

   • 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
2. If authentication issues persist, delete the integration, re-save the configuration, and activate the newly-created integration. For detailed instructions, expand the following section:
   Details

   1. On the Integrations page, find BoldPlatformIntegration{websiteId}. Click the trash icon in the Delete column, and confirm the deletion in the pop up.
   2. Navigate back to Stores > Configuration.
   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. Click the Save Config button at the top of the page. There is no need to change any settings.
   5. Navigate back to System > Integrations.
   6. 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 Checkout.

      
   7. When prompted to allow access to requested resources, click Allow. The extension authenticates and completes installation.
3. If you are still unable to resolve the issue, reach out to Bold's Customer Success team.

Checkout page issues

The following sections outline issues that may occur when attempting to visit the checkout page.

Configuration changes not applied

Problem:

You update the configuration of your Bold Checkout Extension, but when you visit the checkout page, the changes are not applied.

Troubleshooting:

1. Clear the cache using the following steps:
   1. In the Adobe Commerce admin, navigate to System > Tools > Cache Management.
   2. Click the Flush Magento Cache button.
   3. Return to the checkout page and refresh the page to see your changes.
2. If your changes were still not applied, ensure they were applied using the correct scope using the following steps:
   1. Navigate to the Stores > Configuration page in the Adobe Commerce admin.
   2. Find the Scope drop-down menu at the top of the page, and select the website you would like to configure.
      note

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

      
   3. Ensure your changes were applied in the store scope, not just in the Default scope.

Checkout page load error

Problem:

When a customer attempts to check out, the page does not load, and you see an error indicating that something went wrong:

Troubleshooting:

To resolve this issue, try the following troubleshooting steps:

1. Your firewall may be blocking Bold's API calls. Ensure that your store's security settings are configured to accept calls from Bold. For detailed instructions, expand the following section:
   Details

   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:

   Domains

   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

   IP Addresses

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

   • 34.118.185.130
   • 34.152.35.117

   If you are using Bold Booster for PayPal, calls will also come from these additional IPs:

   • 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
2. If the issue persists, you may not have activated the Bold Checkout extension. Follow the steps in the Activate the extension section of the installation guide.
3. If Bold Checkout still does not load when you attempt to check out, locate your error logs, reach out to Bold's Customer Success team and provide the error.

Payment method failed

Problem:

When a store is using Bold Booster for PayPal and a customer attempts to checkout, they get the following "PayPal payment has failed..." error:

Troubleshooting:

Ensure that the store supports payments from the shopper's country. Both the shipping and billing address countries must be supported. Follow these steps to set the country options for your store.

Unknown error processing payment

Problem:

When a customer attempts to check out using PayPal, they get the following "unknown error":

Troubleshooting:

In your PayPal business account admin, update your settings so that the contact phone number is required:

1. In your PayPal business account admin, navigate to Account Settings.
2. Click Website Payments.
3. Next to Website Preferences, click Update.
4. View the Contact telephone number setting.
5. Ensure the Contact telephone number setting is On (required field).

Ensure that the phone number requirement is also enabled in the Bold Checkout admin:

1. In the Bold Checkout admin, navigate to Settings > General Settings.
2. Scroll down to the Checkout Process section, and toggle the Phone Number setting on.
3. Click Save.

Extension not compiled

Problem:

When a customer attempts to check out, the order fails and is not processed. Alternatively, the user might not be able to access Bold Checkout at all.

You might see errors in system.log or exception.log that points to code classes missing, indicating that the extension was not properly compiled.

Troubleshooting:

Ensure that you compile and enable the extension code. Using your terminal, navigate to your project directory and run the following commands:

php bin/magento setup:di:compile
php bin/magento setup:upgrade

Payment gateway issues

Instant payment confirmation error

Problem:

When using PPCP as a payment gateway, you might receive an email from PayPal that includes an alert that mentions instant payment confirmations (IPN). The following snippet shows an example of this email:

Check your server that processes PayPal instant payment confirmations (IPN). IPNs sent to the following URL(s) will not be received:

https://{store_url}/paypal/ipn/

If you don't know this URL, you may be using a service provider that uses IPN on your behalf. Please contact your service provider with the above information.

If this problem persists, it may be that IPNs are disabled for your account.

Troubleshooting:

To correct this issue, disable IPN notifications in your PayPal account by following the instructions in the PayPal documentation.