Download the PHP package byheartlk/botble-genie-payment without Composer
On this page you can find all versions of the php package byheartlk/botble-genie-payment. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
Informations about the package botble-genie-payment
Genie Business Payment Gateway for Botble CMS
A comprehensive payment gateway plugin for Botble CMS that integrates with Genie Business (Dialog Axiata PLC) to accept secure online payments in Sri Lanka. This plugin enables merchants to accept Visa, MasterCard, and American Express payments through Genie Business's robust payment infrastructure.
๐ Features
๐ณ Payment Processing
- Secure Payment Processing: SSL-encrypted transactions with PCI compliance
- Multiple Card Support: Accept Visa, MasterCard, and American Express
- Multi-Currency: Support for LKR (primary) and USD
- Mobile Optimized: Responsive payment pages for all devices
- Real-time Processing: Instant payment confirmation and processing
๐ง Technical Features
- Webhook Integration: Real-time payment status updates
- Signature Validation: Secure API signature verification
- Transaction Management: Complete transaction lifecycle tracking
- Debug Mode: Comprehensive logging for development and troubleshooting
- Sandbox Support: Full testing environment integration
- Database Logging: Detailed transaction and webhook logging
๐ฏ Business Features
- Package Subscriptions: Seamless integration with Botble's job board packages
- Customer Management: Track payments by customer and order
- Payment Analytics: Transaction reporting and status monitoring
- Refund Support: Manual refund process through Genie dashboard
- Multi-language: English language support with easy translation
๐ก๏ธ Security & Compliance
- API Authentication: Secure API key and application ID authentication
- Request Signing: SHA1 signature validation for all transactions
- Environment Separation: Dedicated sandbox and production environments
- Error Handling: Comprehensive error handling and user feedback
- CSRF Protection: Built-in CSRF token validation
๐ Requirements
- Botble CMS: Version 6.4 or higher
- PHP: Version 8.1 or higher
- Extensions:
php-curl
,php-json
,php-mbstring
- Database: MySQL 5.7+ or MariaDB 10.3+
- SSL Certificate: Required for production environment
- Genie Business Account: Active merchant account with Dialog Axiata
๐ Installation
Method 1: Via Admin Panel (Recommended)
-
Download the Plugin
-
Upload via Admin Panel
- Navigate to
Admin Panel > Plugins > Add New
- Click "Upload Plugin" and select
genie-payment.zip
- Click "Install Now"
- Navigate to
- Activate the Plugin
- Go to
Admin Panel > Plugins
- Find "Genie Business Payment Gateway"
- Click "Activate"
- Go to
Method 2: Manual Installation
-
Download and Extract
-
Install Dependencies
-
Run Migrations
- Activate via Admin Panel
- Navigate to
Admin Panel > Plugins
- Find and activate "Genie Business Payment Gateway"
- Navigate to
โ๏ธ Configuration
1. Get API Credentials
-
Login to Genie Business Dashboard
- Visit: https://dashboard.geniebiz.lk
- Use your registered mobile number to login
- Get API Keys
- Navigate to
Connect
section - Copy your
Application ID
andApp Key
- Navigate to
2. Configure Plugin Settings
-
Access Payment Settings
- Go to
Admin Panel > Payments > Payment Methods
- Find "Genie Business Payment Gateway"
- Click "Settings"
- Go to
-
Enter Configuration
- Save and Activate
- Click "Activate" to enable the payment method
3. Test Configuration
-
Use Test Cards (Sandbox Mode)
- Verify Webhook URL
- Ensure
https://yourdomain.com/payment/genie/webhook
is accessible - Check firewall and server configurations
- Ensure
๐ Usage
For Customers
-
Select Payment Method
- During checkout, select "Credit / Debit Card (Powered by Genie Business)"
- Review payment details and terms
- Complete Payment
- Click "Pay Now" to redirect to Genie Business payment page
- Enter card details and complete 3D Secure authentication
- Automatic redirect back to your site upon completion
For Merchants
-
Monitor Transactions
- View transaction status in
Admin Panel > Payments
- Real-time status updates via webhooks
- Detailed transaction logs and analytics
- View transaction status in
- Handle Refunds
- Refunds must be processed manually through Genie Business dashboard
- Update order status in Botble admin panel accordingly
๐ API Integration
Transaction Creation
Status Checking
Webhook Handling
๐งช Testing
Unit Tests
Integration Testing
-
Sandbox Environment
- Set environment to "Sandbox"
- Use provided test card numbers
- Verify webhook delivery
- Payment Flow Testing
Test Cases
- โ Payment method selection
- โ Payment URL generation
- โ Successful payment processing
- โ Failed payment handling
- โ Webhook reception and processing
- โ Transaction status updates
- โ Signature validation
- โ Error handling and logging
๐ง Troubleshooting
Common Issues
-
Payment URL Not Generated
-
Webhook Not Received
- Signature Validation Failed
Debug Mode
Enable debug mode to get detailed logs:
Log Files
๐ Database Schema
Transactions Table
๐ค Contributing
We welcome contributions! Please follow these steps:
-
Fork the Repository
-
Create Feature Branch
-
Make Changes
- Follow PSR-12 coding standards
- Add unit tests for new features
- Update documentation
- Submit Pull Request
- Ensure all tests pass
- Provide clear description of changes
- Reference any related issues
Development Setup
๐ Changelog
Version 1.0.0 (2024-01-01)
- โจ Initial release
- โจ Complete payment gateway integration
- โจ Webhook support
- โจ Transaction management
- โจ Admin dashboard integration
- โจ Multi-currency support
- โจ Comprehensive logging
- โจ Sandbox environment support
Planned Features
- ๐ Automated refund processing
- ๐ Advanced analytics dashboard
- ๐ Multi-language support
- ๐ฑ Mobile app integration
- ๐ผ Merchant dashboard enhancements
๐ License
This project is licensed under the MIT License - see the LICENSE file for details.
๐ Support
Technical Support
- Email: [email protected]
- Phone: +94 722 983 616
- Hours: Monday - Friday, 9:00 AM - 6:00 PM (GMT+5:30)
General Inquiries
- Email: [email protected]
- Phone: 076 076 0760
Documentation & Resources
- API Documentation: https://geniebusiness.stoplight.io/
- Merchant Dashboard: https://dashboard.geniebiz.lk
- Botble CMS: https://botble.com
Community
- Issues: GitHub Issues
- Discussions: GitHub Discussions
- Discord: Botble Community
๐ข About
Genie Business is a comprehensive payment solution by Dialog Axiata PLC, Sri Lanka's premier connectivity provider. This plugin enables seamless integration between Botble CMS and Genie Business payment infrastructure.
Botble CMS is a modern, fast, and flexible content management system built on Laravel framework, perfect for creating professional websites and applications.