Difference between revisions of "Payment Processing Issues"
| (7 intermediate revisions by 3 users not shown) | |||
| Line 1: | Line 1: | ||
| + | Use the instructions below to resolve common payment processing issues: | ||
| + | |||
==Merchant Gateway Declining or Failing== | ==Merchant Gateway Declining or Failing== | ||
| − | + | Check '''Billing > [[Gateway Log]]''' for your payment gateway's returned response. This should indicate the problem. Then, look up the error codes in your payment gateway's documentation or contact their support team. | |
| − | + | For more information on common errors, see each payment gateway's [[Payment_Gateways#Merchant_Gateways|dedicated documentation]]. | |
==Blank Payment Gateway Page== | ==Blank Payment Gateway Page== | ||
| − | + | Usually, this indicates a double copy of a gateway file in the <tt>modules/gateway</tt> directory, either in the <tt>.htaccess/php.ini</tt> file or another non-WHMCS file in the directory. Removing this should resolve your problem. | |
| + | |||
| + | ==Gateway Module Error: Configuration Function (_config) not found== | ||
| + | |||
| + | In WHMCS 7.8 and higher, '''Configuration (<i class="fa fa-wrench" aria-hidden="true"></i>) > System Settings > [[Payment Gateways]]''' ('''Setup > Payments > Payment Gateways''' in WHMCS 7.8 through 7.10) will check whether the gateways in the <tt>/modules/gateways</tt> folder contain the <tt>*_config</tt> function, which is required for use with WHMCS. | ||
| + | |||
| + | * If any gateways are missing this function, a message will display at the top of the page with a list of applicable gateway files. Audit each of them and remove or correct them to resolve this. | ||
| + | * To correct them, add the function to the file according to our [https://developers.whmcs.com/payment-gateways/configuration/ documentation]. | ||
| + | * If you are using a third-party gateway, you may need to contact them to update the gateway module. | ||
| + | |||
| + | This may also indicate unexpected non-gateway files in the <tt>/modules/gateways</tt> folder. If this is the cause, audit and remove the unneeded files. | ||
==User Redirected to Wrong Page on Checkout== | ==User Redirected to Wrong Page on Checkout== | ||
| − | If you have customised your WHMCS header template and added or removed a form, you | + | If you have customised your WHMCS header template and added or removed a form, you must update the <tt>forwardpage.tpl</tt> template file. |
| + | |||
| + | By default, this submits form 0 or 1 on the page. If you add a form to your header, increment the <tt>forms[x]</tt> setting. | ||
==Invalid Access Attempt== | ==Invalid Access Attempt== | ||
| − | To avoid this error, | + | To avoid this error, make sure that you are logging in to the [[Admin Area]] using the exact URL in '''Configuration (<i class="fa fa-wrench" aria-hidden="true"></i>) > System Settings > [[General Settings]]''', or, prior to WHMCS 8.0, '''Setup > General Settings'''. |
| + | |||
| + | For example, if the '''WHMCS System URL''' is <tt><nowiki>http://www.example.com/whmcs/</nowiki></tt>, you would need to log in to your Admin Area at <tt><nowiki>http://www.example.com/whmcs/admin</nowiki></tt>. If you log in at <tt><nowiki>http://example.com/whmcs/admin</nowiki></tt>, omitting the <tt>www.</tt>, you will see the '''Invalid Access Attempt''' message. | ||
| − | + | {{troubleshooting}} | |
Latest revision as of 20:30, 27 April 2022
Use the instructions below to resolve common payment processing issues:
Contents
Merchant Gateway Declining or Failing
Check Billing > Gateway Log for your payment gateway's returned response. This should indicate the problem. Then, look up the error codes in your payment gateway's documentation or contact their support team.
For more information on common errors, see each payment gateway's dedicated documentation.
Blank Payment Gateway Page
Usually, this indicates a double copy of a gateway file in the modules/gateway directory, either in the .htaccess/php.ini file or another non-WHMCS file in the directory. Removing this should resolve your problem.
Gateway Module Error: Configuration Function (_config) not found
In WHMCS 7.8 and higher, Configuration () > System Settings > Payment Gateways (Setup > Payments > Payment Gateways in WHMCS 7.8 through 7.10) will check whether the gateways in the /modules/gateways folder contain the *_config function, which is required for use with WHMCS.
- If any gateways are missing this function, a message will display at the top of the page with a list of applicable gateway files. Audit each of them and remove or correct them to resolve this.
- To correct them, add the function to the file according to our documentation.
- If you are using a third-party gateway, you may need to contact them to update the gateway module.
This may also indicate unexpected non-gateway files in the /modules/gateways folder. If this is the cause, audit and remove the unneeded files.
User Redirected to Wrong Page on Checkout
If you have customised your WHMCS header template and added or removed a form, you must update the forwardpage.tpl template file.
By default, this submits form 0 or 1 on the page. If you add a form to your header, increment the forms[x] setting.
Invalid Access Attempt
To avoid this error, make sure that you are logging in to the Admin Area using the exact URL in Configuration () > System Settings > General Settings, or, prior to WHMCS 8.0, Setup > General Settings.
For example, if the WHMCS System URL is http://www.example.com/whmcs/, you would need to log in to your Admin Area at http://www.example.com/whmcs/admin. If you log in at http://example.com/whmcs/admin, omitting the www., you will see the Invalid Access Attempt message.