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, Secret, and Integration 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, Secret, and Integration 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. |
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. |
| 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. |
Updated 7 months ago