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.
SKU Based FilteringInclude or exclude products for financing. The field should be a comma separated list of product SKUs.
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, Secret, and Integration 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, Secret, and Integration 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.

Bread Pay Messaging App Settings

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

Generic SettingsDescription
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.
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