PHPackages zghraia/magento2-bread-payment - PHPackages - PHPackages [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register) 1. [Directory](/) 2. / 3. [Payment Processing](/categories/payments) 4. / 5. zghraia/magento2-bread-payment ActiveMagento2-module[Payment Processing](/categories/payments) zghraia/magento2-bread-payment ============================== Offers Bread Pay financing and checkout tools for your Magento store v2.4.6(8mo ago)11.7k↓50%[5 PRs](https://github.com/zghraia/magento2-bread-payment/pulls)MITPHPPHP ~8.1||~8.2||~8.3||~8.4 Since Mar 14Pushed 2mo ago1 watchersCompare [ Source](https://github.com/zghraia/magento2-bread-payment)[ Packagist](https://packagist.org/packages/zghraia/magento2-bread-payment)[ RSS](/packages/zghraia-magento2-bread-payment/feed)WikiDiscussions master Synced 1mo ago READMEChangelog (4)DependenciesVersions (10)Used By (0) Bread Pay Checkout for Magento 2 ================================ [](#bread-pay-checkout-for-magento-2) Helping retailers acquire and convert more customers. Bread Pay Features ------------------ [](#bread-pay-features) - Full Funnel. Your shoppers can discover, pre-qualify, and check out from anywhere - your homepage, category page, product page, cart, or checkout. - Real-Time Decision. Pre-qualification is quick and easy. Let your customers learn about their purchase power in seconds without ever leaving your site. Installation ------------ [](#installation) ### Install using Zip archive [](#install-using-zip-archive) 1. Download repository as zip file 2. Unzip contents into `app/code/Bread/BreadCheckout` folder 3. Setup files ( For Canada Merchants ) - Copy file `app/code/Bread/BreadCheckout/etc/adminhtml/system.ca.xml` to `app/code/Bread/BreadCheckout/etc/adminhtml/system.xml` - Copy file `app/code/Bread/BreadCheckout/view/adminhtml/web/js/validation.ca.js` to `app/code/Bread/BreadCheckout/view/adminhtml/web/js/validation.js` 4. Enable module ``` bin/magento module:enable Bread_BreadCheckout bin/magento setup:upgrade bin/magento setup:di:compile bin/magento setup:static-content:deploy ``` ### Install using composer. [](#install-using-composer) 1. Navigate to your Magento 2 root folder 2. Install the Bread Checkout module ``` composer require zghraia/magento2-bread-payment ``` 3. For Canada Merchants only - Copy file `app/code/Bread/BreadCheckout/etc/adminhtml/system.ca.xml` to `app/code/Bread/BreadCheckout/etc/adminhtml/system.xml` - Copy file `app/code/Bread/BreadCheckout/view/adminhtml/web/js/validation.ca.js` to `app/code/Bread/BreadCheckout/view/adminhtml/web/js/validation.js` 4. Enable module ``` bin/magento module:enable Bread_BreadCheckout bin/magento setup:upgrade bin/magento setup:di:compile bin/magento setup:static-content:deploy ``` Usage instructions: ------------------- [](#usage-instructions) ### For US Merchants [](#for-us-merchants) See documentation at Contact your Bread Pay representative for login credentials. ### For Canada Merchants [](#for-canada-merchants) See documentation at Contact your Payplan representative for login credentials. Development Environment Setup ----------------------------- [](#development-environment-setup) This guide sets up a local Magento environment using [markshust/docker-magento](https://github.com/markshust/docker-magento). Refer to the repository for more details, configuration options, and available commands. ### 1. Create Project Directory & Download Docker Template [](#1-create-project-directory--download-docker-template) ``` mkdir docker-magento cd docker-magento curl -s https://raw.githubusercontent.com/markshust/docker-magento/master/lib/template | bash ``` ### 2. Configure environment and versions [](#2-configure-environment-and-versions) Open the compose.yaml file and confirm the PHP and DB versions matches your target environment. For PHP 8.2, ensure the following line is present: ``` phpfpm: image: markoshust/magento-php:8.2-fpm-4 ``` For MySQL, ensure compatible version is used. Magento currently (As of 6/2025) supports: MySQL 8.0 MySQL 5.7 MariaDB 10.2 – 10.6 ### 2a. Trust Internal Root CA (e.g. Netskope) in Container [](#2a-trust-internal-root-ca-eg-netskope-in-container) If you're on a corporate network that intercepts HTTPS traffic (e.g., via Netskope), you may encounter SSL errors like: ``` curl: (60) SSL certificate problem: self-signed certificate in certificate chain ``` To fix this, you must import your organization's root certificate into the container. - Visit in Chrome. - Click the padlock icon → "Certificate is valid". - In the Certification Path tab, select the top-level certificate (e.g., ca.alliancedata.goskope.com). - Click View Certificate → Details → Copy to File. - Save as Base-64 encoded X.509 (.CER) — name it netskope\_root.cer. - Place the file in the project root. - Run these commands ``` docker cp phpfpm:/usr/local/share/ca-certificates/netskope_root.crt ``` ``` docker exec -u 0 -it phpfpm bash update-ca-certificates ``` - This will copy the cert into the phpfpm container and update the container’s trusted certificate store. - You should now be able to run bin/download and composer install without SSL errors. ### 3. Download Magento [](#3-download-magento) Download the Magento version you want (replace 2.4.8 with your desired version): ``` bin/download 2.4.8 ``` ### 4. Set Up Magento Environment [](#4-set-up-magento-environment) Run the following commands to complete setup and install sample data: ``` bin/setup magento.test bin/magento sampledata:deploy bin/magento setup:upgrade ``` Disable Two-Factor Authentication for local development: ``` bin/composer require markshust/magento2-module-disabletwofactorauth bin/magento module:enable MarkShust_DisableTwoFactorAuth bin/magento setup:upgrade ``` ### 5. Install Bread Magento Extension [](#5-install-bread-magento-extension) Clone the Bread extension into app/code and enable the module: ``` cd src/app/code mkdir Bread cd Bread git clone git@github.com:zghraia/magento2-bread-payment.git BreadCheckout cd ../../../../ bin/magento module:enable Bread_BreadCheckout bin/magento setup:upgrade bin/magento cache:flush ``` Resetting Your Local Magento Environment ---------------------------------------- [](#resetting-your-local-magento-environment) To completely remove your local Magento installation and start fresh: ### 1. Navigate to the root of your Magento project: [](#1-navigate-to-the-root-of-your-magento-project) ``` cd /path/to/your/magento-docker-dev ``` ### 2. Run the cleanup script and delete all files (including hidden ones): [](#2-run-the-cleanup-script-and-delete-all-files-including-hidden-ones) ``` bin/removeall rm -rf .[^.]* * ``` ⚠️ Warning: This will permanently delete all files and directories in the current folder. Make sure you’re in the correct location before running this command. ### Health Score 45 — FairBetter than 92% of packages Maintenance72 Regular maintenance activity Popularity21 Limited adoption so far Community17 Small or concentrated contributor base Maturity60 Established project with proven stability Bus Factor3 3 contributors hold 50%+ of commits How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window. **Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores. **Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement. **Maturity (30%)** — Project age, version count, PHP version support, and release stability. ### Release Activity Cadence Every ~52 days Total 4 Last Release 267d ago PHP version history (2 changes)2.4.5PHP ~7.0.13||~7.1.0||~7.1.3||~7.2.0||~7.3.0||~7.4.0||~8.0.0||~8.1.0||~8.2.0 2.4.5-p1PHP ~8.1||~8.2||~8.3||~8.4 ### Community Maintainers ![](https://www.gravatar.com/avatar/9efc32d49ce17f6232c75ba93b6422e624e36c6ad36f6c012251073632d17e4f?d=identicon)[Serzhik](/maintainers/Serzhik) --- Top Contributors [![aleksa-andersinnovation](https://avatars.githubusercontent.com/u/37845675?v=4)](https://github.com/aleksa-andersinnovation "aleksa-andersinnovation (133 commits)")[![KiprotichMaritim](https://avatars.githubusercontent.com/u/12558727?v=4)](https://github.com/KiprotichMaritim "KiprotichMaritim (97 commits)")[![fkhan-bread](https://avatars.githubusercontent.com/u/126727411?v=4)](https://github.com/fkhan-bread "fkhan-bread (94 commits)")[![mirandajohnson](https://avatars.githubusercontent.com/u/19955568?v=4)](https://github.com/mirandajohnson "mirandajohnson (53 commits)")[![dfroneberger](https://avatars.githubusercontent.com/u/12517084?v=4)](https://github.com/dfroneberger "dfroneberger (39 commits)")[![omgitsdev](https://avatars.githubusercontent.com/u/7592820?v=4)](https://github.com/omgitsdev "omgitsdev (35 commits)")[![JelenaAndersInnovations](https://avatars.githubusercontent.com/u/36050928?v=4)](https://github.com/JelenaAndersInnovations "JelenaAndersInnovations (29 commits)")[![serzhik](https://avatars.githubusercontent.com/u/2320879?v=4)](https://github.com/serzhik "serzhik (25 commits)")[![alexnick173](https://avatars.githubusercontent.com/u/30112365?v=4)](https://github.com/alexnick173 "alexnick173 (20 commits)")[![alexxss1986](https://avatars.githubusercontent.com/u/13381082?v=4)](https://github.com/alexxss1986 "alexxss1986 (14 commits)")[![nenadstojic](https://avatars.githubusercontent.com/u/4557206?v=4)](https://github.com/nenadstojic "nenadstojic (4 commits)")[![weigao10](https://avatars.githubusercontent.com/u/32995660?v=4)](https://github.com/weigao10 "weigao10 (2 commits)")[![dksimon](https://avatars.githubusercontent.com/u/8008640?v=4)](https://github.com/dksimon "dksimon (2 commits)")[![sampurcell](https://avatars.githubusercontent.com/u/9835549?v=4)](https://github.com/sampurcell "sampurcell (2 commits)")[![jenlesamuel](https://avatars.githubusercontent.com/u/3932353?v=4)](https://github.com/jenlesamuel "jenlesamuel (1 commits)")[![jdunn-bread](https://avatars.githubusercontent.com/u/127771709?v=4)](https://github.com/jdunn-bread "jdunn-bread (1 commits)") ### Embed Badge ![Health badge](/badges/zghraia-magento2-bread-payment/health.svg) ``` [![Health](https://phpackages.com/badges/zghraia-magento2-bread-payment/health.svg)](https://phpackages.com/packages/zghraia-magento2-bread-payment) ``` ### Alternatives [omnipay/paypal PayPal gateway for Omnipay payment processing library 3156.8M53](/packages/omnipay-paypal)[eduardokum/laravel-boleto Biblioteca com boletos para o laravel 626351.9k2](/packages/eduardokum-laravel-boleto)[tbbc/money-bundle This is a Symfony bundle that integrates moneyphp/money library (Fowler pattern): https://github.com/moneyphp/money. 1961.9M](/packages/tbbc-money-bundle)[2checkout/2checkout-php 2Checkout PHP Library 83740.3k2](/packages/2checkout-2checkout-php)[smhg/sepa-qr-data Generate QR code data for SEPA payments 61717.2k5](/packages/smhg-sepa-qr-data)[omnipay/dummy Dummy driver for the Omnipay payment processing library 271.2M33](/packages/omnipay-dummy) PHPackages © 2026 [Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)