Upgrade Your WooCommerce Store to the Bread 2.0 Platform

The Bread Pay™ 2.0 Platform is here and we’ve enhanced our product with your business in mind! This upgrade will unlock enhancements designed to drive conversion for your business.


This platform upgrade is required in 2023.

Upgrade Steps:

Step 1: Locate Your Platform API Key, API Secret, and Integration Keys

In order to upgrade you will need Platform Access Keys. These keys are available in your new Merchant Portal.

  • Sandbox versions of these keys are located in the Preview Portal and can be used to run test transactions.
  • It is recommended to work with the preview keys first. Access to the Merchant Portals will be setup by the Integration Manager supporting you during the upgrade.
  • You can learn more about logging in to the Merchant Portal here.

Bread Platform Live Credentials: https://merchants.platform.breadpayments.com
Bread Platform Preview Credentials: https://merchants-preview.platform.breadpayments.com

Once logged in, first click on "Account Settings". Then click on the Account Settings drop down and select "Access Keys" to view your credentials. Keep this page open as you will need to reference these keys shortly.


Step 2: Update to the Newest Version of the Bread Pay Plugin(3.2.0 or newer)

The plugin updates should be available within the Installed Plugins page under Update Available, as shown below. Alternatively, the Bread Pay plugin is available on the Wordpress plugin store here.



Earlier Versions of the Bread Plugin Cannot Update Classic Orders Using the WooCommerce OMS

Plugin versions prior to v3.2.0 do not support the ability to make updates to Bread Classic orders using the WooCommerce OMS.

Step 3: Configure the Bread Pay™ App for the Bread 2.0 Platform

  1. From your Installed Plugins page, navigate to Bread Pay > Settings.
  2. Scroll down to the API Settings section.
    a. Click the dropdown for Bread API Version and select Platform.
    b. Note: If you will be using Preview keys for test transactions, select Sandbox in the Environment dropdown. Otherwise, select Production.


Copy Classic API Keys and Paste into Platform API Key Fields

After switching the Bread API Version to Platform, your Classic API Keys may populate in the Platform API Key Fields.

These keys should be copied and pasted in to the Classic API Key fields(If you lose your Classic API keys, they can be found in the Classic Merchant Portal or be provided by your integration manager).

This step is required to be able to manage Bread Classic orders through the WooCommerce OMS.

c. Copy and paste the keys you located in step 1 into the corresponding fields.


d. Scroll to the bottom of the settings page and click Save changes.

The checkout experience has been upgraded to Bread Pay™ 2.0 Platform. All new Orders will be created on our enhanced platform.

Step 4: Configure Bread Settings and Placement/Button Styling


Bread Button Customization Using the Custom CSS Field(Classic only)

Our enhanced platform renders Bread buttons differently. Custom CSS Styling in the settings is for Bread Classic only and will not apply to the new buttons.

In order to customize button styling using CSS, you will need to add the CSS directly in to your website's code.

Applicable settings will automatically transfer over and apply to the new Platform. Additional changes can be made if needed.

Step 5: Update any Custom Integrations (Financing & Category Pages, or Banners)

Any aspects of your Classic integration that directly referenced Bread JavaScript will need to be updated to use the Bread Platform SDK. General guidance on working with the Bread SDK can be found here.

When updating your financing Page, we have an HTML template that can be used. The financing template can be found here.