PHPackages                             mrroot/orange-money-bundle - 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. mrroot/orange-money-bundle

ActiveSymfony-bundle[Payment Processing](/categories/payments)

mrroot/orange-money-bundle
==========================

Symfony bundle for Orange Money payment integration with complete webhook, callback and error handling support

v1.1.0(10mo ago)129MITPHPPHP >=8.1CI failing

Since Sep 2Pushed 10mo agoCompare

[ Source](https://github.com/mrrootc/orange-money-bundle)[ Packagist](https://packagist.org/packages/mrroot/orange-money-bundle)[ Docs](https://github.com/mrrootc/orange-money-bundle)[ RSS](/packages/mrroot-orange-money-bundle/feed)WikiDiscussions main Synced today

READMEChangelog (2)Dependencies (13)Versions (3)Used By (0)

Orange Money Bundle for Symfony
===============================

[](#orange-money-bundle-for-symfony)

[![License: MIT](https://camo.githubusercontent.com/fdf2982b9f5d7489dcf44570e714e3a15fce6253e0cc6b5aa61a075aac2ff71b/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f4c6963656e73652d4d49542d79656c6c6f772e737667)](https://opensource.org/licenses/MIT)[![Symfony](https://camo.githubusercontent.com/95bdaff16a1363403e88b94c77a40bb76e1fba1eeb087192f139fb4445787aba/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f53796d666f6e792d352e34253230253743253230362e78253230253743253230372e782d677265656e2e737667)](https://symfony.com/)[![PHP](https://camo.githubusercontent.com/6b84e9311750c972da98b6d521269a76c32b8928b672000d4a8c5dd7ac866d09/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f5048502d253345253344382e312d626c75652e737667)](https://php.net/)

Symfony bundle for Orange Money payment integration with complete webhook support, callbacks, and advanced error handling.

Features
--------

[](#features)

- **Orange Money payment initiation** with comprehensive validation
- **Transaction status verification** with enhanced parameters
- **Advanced webhook and notification handling** with token validation
- **Robust error handling** with detailed logging
- **Flexible configuration** via environment variables
- **OAuth2 support** for secure API authentication
- **Symfony compatibility** 5.4, 6.x and 7.x
- **Automatic data validation** and sanitization
- **Configurable callback URLs** with security features
- **Webhook spoofing protection** via notification token validation
- **Enhanced payment response handling** with comprehensive data access

Bundle Architecture
-------------------

[](#bundle-architecture)

### File Structure

[](#file-structure)

```
src/OrangeMoneyBundle/
├── DependencyInjection/
│   ├── Configuration.php          # Bundle configuration
│   └── OrangeMoneyExtension.php    # Symfony extension
├── Exception/
│   └── OrangeMoneyException.php    # Custom exceptions
├── Model/
│   ├── PaymentRequest.php          # Payment request model
│   └── PaymentResponse.php         # Payment response model
├── Service/
│   └── OrangeMoneyService.php      # Main service
└── OrangeMoneyBundle.php           # Main bundle class

```

### Flow Diagram

[](#flow-diagram)

```
Application → PaymentRequest → OrangeMoneyService → Orange Money API
     ↓              ↓                ↓                    ↓
Controller ← PaymentResponse ← Token Management ← OAuth2 Response

```

Installation
------------

[](#installation)

### 1. Installation via Composer

[](#1-installation-via-composer)

```
composer require mrroot/orange-money-bundle
```

### 2. Bundle Registration

[](#2-bundle-registration)

Add the bundle to `config/bundles.php`:

```