Download the PHP package bowphp/payment without Composer
On this page you can find all versions of the php package bowphp/payment. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
Informations about the package payment
Bow Payment
The comprehensive payment gateway for Bow Framework. Built to make integrating African mobile money payment providers seamless, secure, and reliable.
Introduction
This package helps developers easily integrate local mobile payment APIs such as Orange Money, Moov Money (commonly called Flooz), MTN Mobile Money, Wave, and Djamo with advanced features like retry logic, rate limiting, transaction logging, and webhook handling.
Supported Providers
- ✅ Orange Money (Ivory Coast) - Fully implemented
- ✅ MTN Mobile Money (Ivory Coast) - Fully implemented
- 📦 Moov Money (Flooz) - Gateway ready, pending API documentation
- 📦 Wave - Gateway ready, pending API documentation
- 📦 Djamo - Gateway ready, pending API documentation
Installation
Install the package using composer, the PHP package manager:
Quick Start
Configuration
Configure your payment providers in your config/payment.php:
Basic Usage
Using with Models
Add the UserPayment trait to your User model:
Advanced Features
Retry Logic
Automatically retry failed API calls with exponential backoff:
Rate Limiting
Protect your application from exceeding API rate limits:
Transaction Logging
Comprehensive audit trail for all payment operations:
Webhook Handling
Secure webhook processing with signature validation:
Exception Handling
Comprehensive custom exceptions for better error handling:
Provider-Specific Usage
Orange Money
MTN Mobile Money
Switching Providers Dynamically
Features
- ✅ Simple, fluent API
- ✅ Multiple payment provider support (Orange Money, MTN Mobile Money)
- ✅ Dynamic provider switching
- ✅ Transaction status verification
- ✅ User model integration via traits
- ✅ Webhook handling with signature validation
- ✅ Transfer support
- ✅ Balance inquiry
- ✅ Automatic retry logic with exponential backoff
- ✅ Rate limiting protection
- ✅ Transaction audit logging
- ✅ Comprehensive exception handling
- ✅ Sandbox and production environment support
Requirements
- PHP >= 7.4 (PHP 8.0+ recommended)
- Bow Framework >= 4.0
- GuzzleHTTP >= 6.5
Testing
Run the test suite:
The package includes comprehensive tests for:
- Transaction logging
- Retry logic
- Rate limiting
- Webhook handling
- Payment configuration
Contributing
Contributions are welcome! Please feel free to submit a Pull Request.
Development Guidelines
- Follow PSR-12 coding standards
- Add tests for new features
- Update documentation
- Ensure all tests pass before submitting PR
Changelog
See UPGRADE_SUMMARY.md for recent changes and improvements.
License
The Bow Payment package is open-sourced software licensed under the MIT license.
Support
If you find this project helpful, consider supporting its development:
Credits
- Franck DAKIA - Lead Developer
- All Contributors
