WHMCS Bohudur Module
Integrate Bohudur Payments into your WHMCS installation using the official Bohudur Payment API.
This module allows WHMCS clients to pay invoices securely via Bohudur’s hosted checkout system, with automatic payment verification and invoice settlement.
Features
- WHMCS-native payment gateway
- Secure API key authentication
- Hosted payment redirection
- One-time idempotent payment execution
- Metadata support (Invoice ID tracking)
- Optional success & cancel webhooks
- Server-side payment verification
- Automatic invoice marking as paid
Requirements
- WHMCS 7.x or later
- PHP 7.4+
- cURL enabled
Installation
1. Download & Upload Gateway Files
Download the Bohudur WHMCS module and upload it to your WHMCS installation.
Upload the zip file where you installed WHMCS directory.
2. Activate the Gateway
- Login to WHMCS Admin
- Go to System Settings → Payments → Payment Gateways
- Activate Bohudur Payments
Configuration
After activation, configure the gateway settings:
| Field | Description |
|---|---|
| API Key | Your Bohudur API key |
| Webhook Success URL | (Optional) URL called when payment is completed |
| Webhook Cancel URL | (Optional) URL called when payment is cancelled |
Important
Never expose your API key in frontend code. Always keep it server-side.
Error Handling
Common Scenarios
| Case | Behavior |
|---|---|
| Invalid payment key | Request rejected |
| Payment already executed | Invoice not duplicated |
| Cancelled payment | User redirected back to invoice |
| API failure | Safe error exit |
Troubleshooting
Payment not marked as paid?
- Ensure callback URL is accessible
- Verify API key is correct
- Confirm payment status is
EXECUTED
Getting 3108 Payment already executed?
- This is expected behavior
- Prevents duplicate payments
Support
For technical support or integration issues, contact in Bohudur Telegram Support.