Payments are not being recorded in my WHMCS installation, invoices stay in Unpaid status

If you are receiving payments into your payment gateway account (Eg. PayPal, 2Checkout, Authorize.net) but this is not being reflected in WHMCS and the invoices are remaining in Unpaid status, it indicates an error or misconfiguration.

Begin your troubleshooting by navigating to the Billing > Gateway Log page within your WHMCS Admin area. Here you should see the communication between WHMCS and your payment gateway. Use the Search/Filter tool to search for the transaction ID of the payment which was not recorded in WHMCS.

  • The Result and Debug columns will contain the response from your payment gateway when it attempted to notify WHMCS of the payment.

The explanation of common errors are located in the Troubleshooting sections of each payment gateway's dedicated page of our documentation. For the more uncommon errors and interpreting error codes, we recommend referring to your payment gateway's own documentation


  • If there is no record of a transaction in the Gateway Log, this indicates a misconfiguration is causing notifications from your payment gateway not to reach your WHMCS installation.

Refer to the Configuration sections of each payment gateway's dedicated page of our documentation, and ensure any extra configuration steps have been completed.


Once the error or misconfiguration has been corrected, future payments will be automatically recorded in WHMCS and invoices marked paid. Transactions which were not recorded automatically can be added manually.

  • 901 Users Found This Useful
Was this answer helpful?

Related Articles

I'm seeing a blank or partially formatted page

Encountering a blank page or partially formatted page suggests that a fatal PHP error is...

What can I do as a developer myself to extend WHMCS?

WHMCS has a modular design which allows you to create your own modules to drop-in for additional...

I'm seeing a Down for Maintenance error when accessing my WHMCS admin area

Whilst the WHMCS software is being updated, a "Down for Maintenance" message is displayed This...

I would like to offer WHMCS to my customers, can I?

WHMCS offers both an affiliate referral program, and reseller program, where you are rewarded for...

I forgot the password to administrative area of my WHMCS installation? Can I reset it?

Should you forget your administrator password for WHMCS, you can request a password reset using...

Powered by WHMCompleteSolution