Download the PHP package elmmac/ikhokha without Composer
On this page you can find all versions of the php package elmmac/ikhokha. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
Informations about the package ikhokha
ElmMac - Laravel iKhokha Payment Integration API 💳
Laravel iKhokha Payment Integration API (elmmac/ikhokha) 💳
Official Laravel package to integrate iKhokha Pay Links and Webhooks into your Laravel projects.
📘 ElmMac iKhokha Laravel Package API
This Laravel package provides a native iKhokha payment integration layer, complete with:
- Webhook handling
- Database logging
- API client functionality
- Optional UI blade views for frontend integration
- Paylink creation
- Easily extendable API client
Perfect for:
✔ SaaS platforms ✔ Marketplaces ✔ Payment-based apps ✔ Donation systems ✔ Subscription-like flows
🔒 Secure, scalable, and modular — ideal for custom Laravel SaaS and marketplaces.
🛆 Features
✅ Webhook listener & processor\
✅ Auto-persist IkhokhaPayment records\
✅ Extendable IkhokhaClient for outbound API calls\
✅ Built for Laravel 9/10+\
✅ Clean PSR-4 package structure\
✅ Optional config, views, and migration publishing\
✅ Optional UI views included (Blade templates)
Current Package Structure
🛆 Installation
Step 1: Install via Composer
Step 2: Register Service Provider (if needed)
For Laravel < 5.5 or explicit config
⚙️ Configuration
Optional: Publish the config
This publishes: config/ikhokha.php
Edit your .env file:
📄 Publish Views (Optional UI)
Views will be published to: resources/views/ikhokha
Use them as base templates or customize freely.
🗃️ Migrations
Optional: Publish Migrations
Migration will be published to: database/migrations/
Then run:
Model:
Table: ikhokha_payments
Add relationship in your User.php:
And in IkhokhaPayment.php:
🛆 Example Manual Entry:
🔗 Create Payment Link Payload - REQUEST | Refer to 🔗 iKhokha API Overview for more.
Use this structure to initiate payment (All iKhokha Requests & Responses MUST be in JSON format):
Create Paylink/Payment Link Response Object
🔁 Webhook Setup | Refer to 🔗 iKhokha API Overview for more.
📬 Webhook URL:
Required headers:
📨 Sample Payload:
🚦 Route Summary
| Method | URL | Purpose |
|---|---|---|
| POST | /ikhokha-initiate |
Create payment link |
| GET | /ikhokha/success |
Redirect page after payment |
| GET | /ikhokha/failed |
Failed payment view |
| GET | /ikhokha/cancel |
Cancel payment view |
| POST | /api/ikhokha/webhook |
Webhook callback |
📋 Artisan Helper Tags (Optional)
For dev reminders:
Use only the ones you need! 💡
🧠 Roadmap
- Full unit testing with PHPUnit
- Laravel Octane compatibility
- Tokenized card billing
- Refunds & reversals
- Multi-merchant support
- Optional payment UI component scaffolds
iKhokha Subscription Tokenization Eloquent Traits (Billable) Octane compatibility
🤝 Contributing
Pull requests welcome. Open an issue for proposals or fixes.\ Make sure tests pass if you're submitting functional changes.
🙏 Credits
Developed with 🚀 by ElmMac Pty Ltd\
Maintained by @ElmMac - Misael Cruise Mutege — WhatsApp: +27786411181 Durban, South Africa\
Digital Dev | Hustler Mode: ON 💼
📄 License
MIT License © ElmMac " ||| just edit according to the chamges say like the folder structure excluding the package folder, etc depending on what has changed so far.