Skip to main content

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

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:

Unexpected Error

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.

Unexpected Error

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

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: Screenshot of authorization issue: Shop not found

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:

    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
  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. Screenshot of deleting an integration
    2. Navigate back to Stores > Configuration. Configuration menu screenshot
    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. 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.

      Screenshot of integrations list
    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. Configuration menu screenshot
    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.

      Scope dropdown screenshot
    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:

Something went wrong screenshot

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:

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

PayPal payment has failed screenshot

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":

Unknown error screenshot

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.