Payment Webhook Gateway
Unified payment validation and confirmation API for Kenyan banks and mobile money providers. Seamlessly integrate rent collection across multiple payment channels.
Supported Payment Providers
Core Features
🔐 Payment Validation
Real-time validation of incoming payment requests before processing. Validates tenant account details, rental unit information, and payment amounts to ensure accuracy before accepting the payment.
✅ Payment Confirmation
Confirmation webhooks receive final payment status from banks and mobile money providers. Once confirmed, the system updates tenant records, generates receipts, and triggers notifications.
🏢 Multi-Tenant Architecture
Isolated payment processing for multiple properties and landlords. Each tenant domain has its own secure webhook endpoints, ensuring data privacy and independent workflows.
🔄 Multiple Payment Methods
Support for M-Pesa STK Push, Paybill, Till Numbers, and direct bank transfers from all major Kenyan banks. Unified API handles different payment formats seamlessly.
📊 Real-time Processing
Instant payment validation and confirmation with webhook notifications. Tenants receive immediate feedback on their rent payments with automatic receipt generation.
🛡️ Secure & Compliant
OAuth 2.0 authentication with Laravel Passport, encrypted data transmission, and comprehensive audit logging. Fully compliant with banking security standards.
How Payment Validation Works
Validation is the first step in the payment flow. When a tenant initiates a payment (e.g., paying rent via M-Pesa or bank transfer), the payment provider sends a validation request to our API endpoint.
The validation webhook checks:
- ✓ Is the tenant account number valid?
- ✓ Does the rental unit exist in the system?
- ✓ Is the payment amount correct?
- ✓ Are there any outstanding balances or overpayments?
If validation passes, the payment provider proceeds with the transaction. If it fails, the payment is rejected before any money is transferred, preventing errors and ensuring data accuracy.
How Payment Confirmation Works
Confirmation is the final step after a successful payment. Once the payment provider completes the transaction, they send a confirmation webhook with the payment details.
The confirmation webhook:
- 📝 Records the payment in the tenant's account
- 💰 Updates outstanding balances and payment history
- 🧾 Generates a payment receipt automatically
- 📧 Sends SMS/email notifications to the tenant
- 📋 Logs the transaction for audit and compliance
This two-step validation-confirmation process ensures accurate payment tracking and provides immediate confirmation to tenants that their rent has been received and processed.
API Endpoint Structure
All webhook endpoints follow a standardized pattern:
POST /api/v1/{domain_name}/{endpoint}
Each tenant domain receives unique webhook URLs for different payment providers, ensuring isolated and secure payment processing. This multi-tenant architecture allows landlords to manage multiple properties independently.