Testing The Bread Modal

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
  • Credit Card #: 4242 4242 4242 4242
  • Exp: Any date after today’s date
  • CVC: 123

Your Sandbox API and Secret Keys can be found in the "Account" settings of your Sandbox Merchant Portal.


Sandbox Testing

You will not receive emails nor text messages when testing in sandbox mode. Credit card details are only required for “Downpayment” transactions or Splitpay transactions.

Test checkouts are required to be completed at each step of the shopping journey where checkout will be enabled. Generally, this means:

  • Product Detail Page
  • Cart Page
  • Checkout / Payment page
  • Backend "Carts" (Magento, WooCommerce, etc.) if applicable

At each step, multiple checkouts should be completed. These should pull upon a variety of use cases to ensure that situations that may modify the price are taken into account. A non-exhaustive list of these are:

  • Checkouts with and without taxes
  • Checkouts with and without shipping costs
  • Checkouts where billing and shipping addresses are different
  • Checkouts with and without discounts applied
    • Discount codes
    • Cart-rule discounts
  • Checkouts with and without add-ons / configuration changes
    • Ensure that configurations show up as expected in your systems
  • Checkouts across different browsers: (Chrome, Safari, Firefox, Edge, IE)

A successful checkout is one where all of the following apply:

  • A new transaction is created in the Bread merchant portal with an accurate transaction amount
  • The Bread transaction is in an "Authorized" or "Settled" state
  • The order appears as expected in your order management system (OMS)
  • The Bread transaction has an "OrderId" that accurately matches the order identifier from your OMS


Launching in Production

If you are using a supported e-commerce plugin, launching in production is just a matter of configuring extension settings to move Bread from "sandbox" to "production" mode.

For Direct API merchants, the production bread.js script should swapped in, and transaction management actions should be pointed at our Live API endpoint. Please ensure both are configured with your live API keys.