WHMCS Integration

​

Prerequisites

• WHMCS 8.0+
• A running OwnPay instance
• An API key and webhook secret from Developers → API Keys

​

Installation

​

Configuration

​

Enable the gateway

1. Log in to WHMCS Admin
2. Navigate to System Settings → Payment Gateways
3. Click OwnPay to activate it

​

Configure gateway settings

​

Payment flow

WHMCS invoice created
       |
       v
Customer clicks "Pay Now"
       |
       v
Module creates payment via OwnPay API
       |
       v
Customer redirected to OwnPay checkout
       |
       v
Payment completed → OwnPay sends webhook
       |
       v
Callback marks WHMCS invoice as paid

​

Webhook configuration

1. Your callback URL is:

https://your-whmcs-domain.com/modules/gateways/callback/ownpay.php

2. In OwnPay, go to Developers → Webhooks and add this URL
3. Select the payment.completed event
4. Copy the webhook signing secret into the WHMCS gateway settings

​

Test mode

​

Supported features

• Automatic invoice payment on webhook callback
• Signature verification on every callback
• Test mode toggle
• Multi-currency support
• Refund handling from WHMCS admin

​

Troubleshooting

1. Go to Billing → Gateway Log and filter by ownpay
2. Check that the webhook secret matches exactly in both OwnPay and WHMCS
3. Verify your OwnPay instance can reach the callback URL
4. Enable debug logging in WHMCS for detailed request/response logs

​

Related pages

• PHP SDK
• WooCommerce plugin
• Webhooks
• Testing payments