Shopify Bread Settings

Bread has two distinct parts in the Shopify Admin, the Bread Pay Payments App and the Bread Pay Messaging App. Each app has settings that can be configured.

Bread Pay Payment App Settings

These can be found by navigating to Shopify Admin > Settings > Payments. Locate Bread Pay and click Manage > Manage.

Settlement OptionsDescription
Settle on CheckoutAutomatically settle transactions upon customer checkout.
Note: Bread Approval is required to enable this feature. Merchants must fulfill 90% of orders within 3 days to qualify.
Settle on Capture or FulfilledManually settle through your Shopify order management system by clicking "Captured" or "Fulfilled".
Select if you have Shopify Payment Capture set to "Manual"
Settle on FulfilledManually settle through your Shopify order management system by clicking "Fulfilled".
Select if you have Shopify Payment Capture set to "Automatic"
Note: This option requires the Bread Pay Messaging App to be installed.

📘

Understanding Settlement

Settling an order indicates that funds have been captured, and should be aligned with fulfillment of product. Once a transaction has been settled, the customer's payment cycle begins and funds are en route to you via ACH to be received in 0-2 business days. Installment loan orders must be settled within 90 days and SplitPay orders in 14 days.

Shopify Payment Capture Settings: When Shopify payment capture is set to Automatic, Bread orders will auto settle on Checkout, unless you select "Settle on Fulfilled" as your settlement method.

Generic SettingsDescription
Enable Healthcare ModeEnable this setting if you qualify as a healthcare or healthcare-related merchant (e.a., CPAP machines, mobility scooters). With Healthcare Mode enabled, the Bread app does not accept personally identifiable information (PII) from your store in order to meet healthcare compliance.
Custom Checkout Shop NameCustomize your shop name displayed at the top of the Bread redirected checkout experience. If not customized, this will display your stores myshopify.com shop name.
AuthenticationDescription
Use sandbox (test) modeWhen selected transactions are simulated and customers can’t make real purchases through Bread. Sandbox API Keys are required for test transactions. Note: You will also need to enable test mode in the Payment Settings. From the Shopify admin, navigate to Settings > Payments. Locate Bread Pay and click Manage.
Live API & API Secret KeysThese Keys are required to accept real customer orders. Your keys can be located by logging into the Merchant Portal. Be sure to carefully enter these keys with no leading or trailing spaces.
Sandbox API & API Secret KeysThese Keys are required to run test transactions. Your keys can be located by logging into the Sandbox Merchant Portal. Be sure to carefully enter these keys with no leading or trailing spaces.
Additional SettingsDescription
Targeted FinancingA full reference on targeted financing can be found here.
Enable Shopify Plus embedded checkoutSelect this option in order to embed the Bread modal experience directly into the Shopify Checkout, instead of redirecting to Bread. This feature requires Shopify Plus and additional code added to your checkout.liquid files.
Automatically cancel transactions with a declined remainder paymentAutomatically cancel transactions with a declined remainder payment
Use Shopify draft orders to calculate taxEnable this setting to allow Bread to create/delete temporary Shopify draft orders for the purpose of calculating tax. In certain cases, this feature allows Bread buttons to capture tax more accurately

Bread Pay Messaging App Settings

These can be found by navigating to Shopify Admin > Apps > Bread Pay Messaging

Generic SettingsDescription
Enable Shopify webhooks for updating orders (Strongly recommended)Enable this setting to ensure changes to orders in Shopify – for example, capturing payments or refunding orders in the Shopify orders view – will update transactions in your Bread Merchant Portal. Disabling this setting means orders may not be automatically updated in the Bread merchant portal.
Select if Bread x Shopify javascript files are manually integrated.Enable this setting if you need to manually override parts of the app’s default behavior. Prevents the Bread script from loading via the app.
Add Bread Scripts on 2.0 Themes (Select if you are migrating from our gateway app and modified liquid files)Enable this if you have a Shopify 2.0 Theme and are integrating bread via .liquid snippets.
Enable Healthcare ModeEnable this setting if you qualify as a healthcare or healthcare-related merchant (e.a., CPAP machines, mobility scooters). With Healthcare Mode enabled, the Bread app does not accept personally identifiable information (PII) from your store in order to meet healthcare compliance.
Use Shopify order ID instead of order number in Merchant's Portal.Enable this feature if you want to send Bread the Shopify Order ID and not the Shopify Order number.
Button SettingsDescription
Enable add to cart from product detail pagesEnable this setting to give customers the option to add products to their cart directly within the Bread modal. Customizations to your product page may break add to cart functionality. If you are using third party apps to handle product options/configurations or forms for entering custom details (i.e. an engraving or personal note), you should disable the add to cart feature.
Show ‘As low as’ promotional text and tooltip if users aren’t logged in to BreadShow ‘As low as’ promotional text and tooltip if users aren’t logged in to Bread
Disable button and show price per month text if users are logged in to Bread (Not recommended)Disable button and show price per month text if users are logged in to Bread (Not recommended)
Custom CSS for Product and Cart ButtonsCustom CSS for Cart ButtonCustom CSS which will style the Bread button on Product and Cart pages, if blank the Bread button will keep its default styling.
Custom CSS for Cart ButtonCustom CSS which will style the Bread button on Cart pages, if blank the Cart button will use the CSS from the Custom CSS for Product and Cart Buttons field
Authorize read_Products PermissionsDescription
AuthorizeIf Product images are not displayed in Breads redirected Checkout experience, click Authorize to give bread permission to view product details.

What’s Next