Webhook Setup

Webhooks deliver Rabisu events (server set up, suspended, price changed) to your module instantly. Cron keeps running as a fallback.

Setup

1. Get the Webhook Secret from the Become a Reseller ("Bayi Ol") screen in the Rabisu customer panel.
2. Paste it into the Webhook Secret field on the Addons > Rabisu Bayi > Settings tab and save.
3. Open the Addons > Rabisu Bayi page.

The module registers its receiver URL with Rabisu by itself. No manual registration is needed.

Receiver URL:

https://<your-whmcs>/modules/addons/rabisu/webhook.php

This URL must be reachable from the internet and use HTTPS.

Signature verification

• Rabisu adds an X-Rabisu-Signature-V2: t=<unix>,v1=<hmac> header to every request.
• The signature is HMAC-SHA256 over "{t}.{event_type}.{body}".
• Requests older than 5 minutes are rejected. Keep your server clock accurate (NTP).
• An invalid signature returns 401. Rabisu does not retry that request.

Handled events

Event	What the module does
service.created	Activates the service. Writes IP, hostname and password to WHMCS.
service.suspended / unsuspended / terminated	Updates the service status.
product.price_changed	Creates a price decision.
product.stock_changed	Opens or closes the product for ordering.
product.disabled	Hides the product.

Server ready email

When setup finishes, the IP, hostname and password are written to the WHMCS service. The webhook, cron or opening the service page does this, whichever comes first.

Then the customer gets the Rabisu Sunucu Hazir email once.

• The template is created automatically on first use: in the system language, with Turkish and English translations.
• You can edit or disable it under System Settings > Email Templates.
• The email is sent with your own WHMCS email (SMTP) settings.
• No email is sent for services linked manually with rabisuid.

Troubleshooting

Symptom	Fix
401 error	The server entry and the addon settings use different API keys. Make them the same.
Signature errors keep rising	Check that the addon Webhook Secret matches the one on the Become a Reseller screen.
No webhooks arriving	Check the last webhook time under Health tab. Make sure the URL is HTTPS and reachable.

Rabisu stops the URL after 5 failed attempts in a row. Once fixed, contact Rabisu support.