Download the PHP package bd-payments/laravel-payment-gateway without Composer

Laravel Payment Gateway Package

A comprehensive Laravel 12 package for integrating multiple payment gateways (Nagad, bKash, Binance, PayPal, Rocket, Upay, SureCash, UCash, MCash, MyCash, AamarPay, ShurjoPay, SSLCOMMERZ) with PHP 8.4+ support, featuring advanced payment management, invoice generation, problem resolution, enhanced security features, and AI-powered management.

Features

• 🚀 Laravel 12 & PHP 8.4+ Support - Built with modern Laravel and PHP features
• 💳 Multiple Gateways - Support for 13+ payment gateways including Nagad, bKash, Binance, PayPal, Rocket, Upay, SureCash, UCash, MCash, MyCash, AamarPay, ShurjoPay, SSLCOMMERZ
• 🔒 Enhanced Security - Advanced fraud detection, payment tampering protection, data encryption, and comprehensive security features
• 📝 Comprehensive Logging - Track all payment operations with detailed logs
• 🧪 Well Tested - Full test coverage with PHPUnit and Laravel testing
• 🛠️ Easy Integration - Simple facade and service provider integration
• 📊 Rich Models - Eloquent models for payments, logs, refunds, and invoices
• 🎨 Beautiful Views - Responsive payment forms and result pages
• ⚡ Performance - Caching, rate limiting, and optimized database queries
• 📋 Payment History - Complete payment lifecycle tracking
• 🧾 Invoice Generation - Automatic invoice creation and management
• 🔄 Refund Management - Comprehensive refund tracking and history
• 🚨 Problem Resolution - Advanced problem reporting and resolution system
• 📊 Admin Dashboard - Complete admin interface for payment management
• 📈 Analytics - Payment statistics and reporting
• 🎯 Status Tracking - Real-time payment status monitoring
• 🛡️ Fraud Protection - Advanced fraud detection and prevention
• 🔐 Data Encryption - Automatic encryption of sensitive payment data
• 🚫 Tampering Protection - Payment integrity verification and hash validation
• ⚡ Rate Limiting - Intelligent rate limiting to prevent abuse
• 🤖 AI Agent - Intelligent payment management, fraud detection, and automated support
• 📊 Smart Analytics - AI-powered insights and recommendations
• 🔮 Predictive Analytics - Payment failure prediction and risk assessment
• 🎯 Optimal Gateway Selection - AI-driven gateway recommendation based on success rates
• 📱 QR Code Generation - Dynamic QR codes for payments, invoices, and receipts
• 📊 Transaction Reports - Comprehensive analytics and reporting system
• 📈 Export Functionality - PDF, Excel, CSV export options
• 📊 Analytics Dashboard - Real-time insights and metrics
• 🔍 Fraud Analysis - Advanced fraud detection and risk assessment
• 👥 Customer Behavior Analysis - Customer segmentation and behavior insights

Installation

Publish Configuration

Publish Migrations

Run Migrations

Publish Views (Optional)

Configuration

Environment Variables

Add these to your .env file:

Configuration File

The package will create config/payment-gateway.php with comprehensive configuration options.

Quick Start

Basic Usage

Using Service Injection

Using Models

Advanced Features

Payment History Tracking

Invoice Generation

Security Features

AI Agent Features

Problem Resolution System

Admin Dashboard

API Reference

PaymentGateway Facade

QR Code Generation

Transaction Reports

Payment Model

Routes

The package automatically registers the following routes:

Middleware

The package includes several middleware for security and rate limiting:

PaymentGatewayMiddleware

Logs all payment operations and validates gateway parameters.

WebhookSignatureMiddleware

Verifies webhook signatures for secure webhook processing.

RateLimitMiddleware

Implements rate limiting for payment operations.

PaymentSecurityMiddleware

Advanced security middleware with fraud detection and tampering protection.

Views

The package includes beautiful, responsive views:

• Payment Form (payment-gateway::payment-form) - Payment initialization form
• Success Page (payment-gateway::success) - Payment success page
• Failed Page (payment-gateway::failed) - Payment failure page

Customizing Views

Then modify the views in resources/views/vendor/payment-gateway/.

Logging

The package provides comprehensive logging:

Testing

Error Handling

The package provides specific exception types:

Webhooks

Configure webhook endpoints in your .env:

Database Schema

The package includes migrations for:

• payments - Payment records
• payment_logs - Payment operation logs
• payment_refunds - Refund records

Security Features

• Advanced Fraud Detection - Multi-layered fraud detection system
• Payment Tampering Protection - Hash-based integrity verification
• Data Encryption - Automatic encryption of sensitive payment data
• Rate Limiting - Intelligent rate limiting to prevent abuse
• Webhook Signature Verification - Secure webhook processing
• Data Sanitization - Automatic sanitization of sensitive data
• HTTPS Enforcement - Optional HTTPS requirement
• Input Validation - Comprehensive validation rules
• CSRF Protection - Nonce-based CSRF protection
• IP-based Security - Suspicious IP detection and blocking

Performance Features

• Caching - Configurable caching for improved performance
• Database Optimization - Efficient queries with proper indexing
• Logging Control - Optional logging to reduce overhead
• Async Processing - Support for background job processing

Contributing

1. Fork the repository
2. Create a feature branch
3. Make your changes
4. Add tests for new functionality
5. Ensure all tests pass
6. Submit a pull request

License

This package is open-sourced software licensed under the MIT license.

Support

For support and questions, please open an issue on GitHub or contact us at [email protected].

Database Schema

The package includes comprehensive database migrations:

• payments - Payment records with full lifecycle tracking
• payment_logs - Detailed operation logs
• payment_refunds - Refund management
• payment_histories - Complete payment history
• payment_problems - Problem reporting and resolution
• payment_problem_comments - Problem discussion threads
• invoices - Invoice generation and management
• invoice_items - Invoice line items

Admin Features

Payment Management

• View all payments with filtering and search
• Update payment status manually
• View detailed payment information
• Export payment data to CSV
• Real-time payment statistics

Problem Resolution

• Report and track payment problems
• Assign problems to admin users
• Add comments and attachments
• Set priority and severity levels
• Resolve problems with detailed notes

Invoice Management

• Generate invoices automatically
• Send invoices via email
• Download invoice PDFs
• Track invoice status
• Manage invoice items and calculations

Analytics Dashboard

• Payment statistics and trends
• Problem resolution metrics
• Invoice generation reports
• Gateway performance analysis
• Revenue tracking

Changelog

v3.0.0

• Payment History Tracking - Complete payment lifecycle monitoring
• Invoice Generation - Automatic invoice creation and management
• Problem Resolution System - Advanced problem reporting and resolution
• Admin Dashboard - Comprehensive admin interface
• Refund Management - Enhanced refund tracking and history
• Analytics & Reporting - Payment statistics and insights
• Status Monitoring - Real-time payment status tracking
• Enhanced Security - Advanced problem resolution workflows

v2.0.0

• Laravel 12 support
• PHP 8.4+ support
• Added Binance payment gateway
• Complete Laravel package structure
• Comprehensive testing
• Beautiful responsive views
• Advanced security features
• Performance optimizations

v1.0.0

• Initial release
• Support for Nagad and bKash payment gateways
• Basic Laravel integration