Test the Bread Extension


Please view Testing your Bread Integration for instructions on testing your integration.

Testing your Bread integration is a critical step in ensuring a smooth experience for your customers and your team. We recommend thoroughly testing Bread button functionality on each view: product, cart, and checkout. Make sure to complete a few test checkouts and confirm those orders appear in your order management system. Confirm that Bread is in sandbox mode before attempting test checkouts.

Notes on testing Bread in sandbox mode:
When filling out the Bread form, feel free to make up ‘borrower’ credentials – no real credit is pulled, and no texts or emails are sent by Bread.

Testing the Bread Button

Get started by confirming that the Bread extension is set to sandbox mode:

Next, find a Bread checkout button on either a product page, or add a few items to the cart and find the Bread checkout button on the cart overview page. Click on the Bread button to open the Bread modal.

After you click the Bread Button, enter:

  • 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

Once you are approved you should see a menu of financing options. Select an option and proceed by clicking Review Your Order. Provide a shipping address and then Review Your Order. Finally, select the checkbox next to the disclosure and then hit Accept & Check Out to complete your test transaction.

After Bread completes the order, you should be redirected to the Magento 2 confirmation page. Navigate to your Magento 2 OMS and confirm that the Bread transaction appears in your order list. You should also confirm that the order appears in the Bread sandbox merchant portal at https://merchants-sandbox.getbread.com.

Testing Order Management

Once you have completed a few successful test transactions, we recommend confirming that order management features are working with Bread orders. Take a look at Manage Transactions in Magento 2 for instructions on how to manage orders.

Authorized Orders

If your Bread extension is set to authorize, but not settle Bread transactions, make sure to confirm that settle actions push to the Bread merchant portal. First, complete a checkout with Bread to create a transaction in both your Magento 2 OMS and the Bread sandbox merchant portal. Within the Bread merchant portal, the transaction status should say authorized. Next, find the order in Magento 2 and then create and submit an invoice. This should push to the Bread merchant portal and the transaction status should now say settled.

Cancel/Refund Orders

Authorized orders can be canceled. Test this functionality by using the cancel or void actions in Magento 2 and confirm the transaction status in the Bread merchant portal has been updated to Canceled.

Settled orders can be refunded. To test this functionality, create a partial or full refund with a Credit Memo in Magento 2 and confirm the transaction status in the Bread merchant portal has been updated to Refunded.

Enabling Logging

When troubleshooting issues with your Bread integration, you should turn on Enable Logging under the Bread extension settings. This will enable extra error logging within Magento 2 for the Bread extension.