Magento 1 Integration Steps

STEP 1: Install and Configure Bread Extension

Installation Steps

Download the Bread extension package from the Magento Marketplace: (Note: Starting on July 7, 2020, all M1 extensions will only be available on until 8/6/2020. Please reach out to your Success point of contact to acquire the Bread extension.)
Log into your Magento store’s admin back end. From the System menu, choose Magento Connect -> Magento Connect Manager.
Under the “Install New Extensions” section, paste the extension key obtained from the Magento Marketplace and click Install.

Plugin Settings And Configuration

In this section we will first walk through the steps to get Bread working on your Magento 1 site. Bread’s settings are found in your store in the Configuration page, located under the System menu. Once there, choose Payment Methods under Sales on the left.


Basic Settings:

  1. Make sure that Enable Bread is set to Yes.
  2. Set Sandbox (Test) Mode for integration and testing.
  3. Leave the Production API Key and Production API Secret Key fields blank for now.
  4. Enter the sandbox public and secret API Keys provided by your account manager in the fields labeled Sandbox API Key and Sandbox API Secret Key.
  5. Set Payment Action to Authorize & Capture to request for the immediate capture of funds upon checkout. Please speak with your Success account manager before enabling Authorize & Capture.
  6. Set Skip Checkout Review Step to Yes to redirect customers to your standard confirmation page upon completing a checkout with Bread.
  7. Click Save Config in the top right corner of the page.

STEP 2: Style The Bread Button

Bread is highly customizable, and the Bread button and modal can be styled to match your site’s theme.

Button Styling

The Bread button can be styled using custom CSS, however, the CSS must be supplied through the Bread Extension Settings in the appropriate section. The CSS must be compressed into a single-line string (using a service such as CSS Minifier).


Note: Please review the Style The Bread Button for an explanation of the Bread button HTML structure and different button states. All CSS values contained in quotes should use double quotes.

Positioning and Sizing

Positioning of the Bread button is controlled by the settings in the Bread plugin. For category, product, cart and checkout pages you can select whether to show bread on that page and where you want to position it on the page.

Step 3: Test the Bread Extension

We strongly recommend you test your Bread integration with your sandbox API keys and our sandbox domain before pushing Bread live on your production site. You can leverage the following dummy data when testing Bread in sandbox mode.

  • Any name, address and email
  • Mobile Number: A random sequence of 10 digits – don’t use duplicates or sequential numbers (e.g. 555-555-5555 or 123-456-7890)
  • Birth Date: A birth date before 2000
  • Last 4 Digits of SSN: 07xx (Any 4-digit number starting with 07, such as 0789) to simulate approval, or 0400 to simulate denial
  • Mobile Code / Token: 1234

Note: You will not receive emails nor text messages when testing in sandbox mode. Please refer our Testing documentation for additional guidelines.

STEP 4: Going Live With Bread

  1. Access Live Merchant Portal: Ask your main Success point of contact for access to your live merchant portal
  2. Enter Production Keys: Navigate to Bread Extension settings under System > Configuration > Sales > Payment Methods. Bread will be present among the available payment methods. Enter your live API key and Secret key (found in the live merchant portal under Account Settings) in the fields labeled Production API Key and Production API Secret Key.
  3. Set Sandbox (Test) Mode to No
  4. Save your settings.
  5. Customize Live Bread Modal: Customize your live Bread modal in your live merchant portal under Checkout Settings. These settings are not automatically carried over from your sandbox merchant portal.

Note: If you setup a financing page make sure to follow instructions to prepare for production, including changing the script reference and API keys.