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 Options	Description
Settle on Checkout	Automatically 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 Fulfilled	Manually settle through your Shopify order management system by clicking "Captured" or "Fulfilled". Select if you have Shopify Payment Capture set to "Manual"
Settle on Fulfilled	Manually 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 Settings	Description
Enable Healthcare Mode	Enable 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 Name	Customize 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.

Authentication	Description
Use sandbox (test) mode	When 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 Keys	These 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 Keys	These 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 Settings	Description
Targeted Financing	A full reference on targeted financing can be found here.
Enable Shopify Plus embedded checkout	Select 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 payment	Automatically cancel transactions with a declined remainder payment
Use Shopify draft orders to calculate tax	Enable 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 Settings	Description
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 Mode	Enable 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 Settings	Description
Enable add to cart from product detail pages	Enable 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 Bread	Show ‘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 Button	Custom 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 Button	Custom 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 Permissions	Description
Authorize	If Product images are not displayed in Breads redirected Checkout experience, click Authorize to give bread permission to view product details.