With these individual payment gateways you can integrate the payment methods of the payment service provider stripe.com into WHMCS. These payment gateways support IPN (Instant Payment Notification). IPN means that the invoice is marked as “Paid” when the payment is successfully executed and the service ordered from you can be automatically executed (provided you have set up automatic execution after receipt of payment in the product configuration). If the payment is not successful, the customer receives a message that the payment has not been made.

System requirements

• Executable WHMCS 8.6 – 8.11 installation
• Admin access to WHMCS
• Installed Ioncube Loader (at least version 13)
• Active account at stripe.com with corresponding activated payment method
• PHP 7.4, 8.1 or 8.2

Installation

• Please upload the module files to your web space and then activate the gateway in the admin area of WHMCS
• Log in to the Stripe Dashboard and click on “Developer” and then on “API keys”
• Then create an API key in the “Restricted keys” section if no key has yet been generated for your WHMCS instance.
• When asked what kind of key you would like to generate, please select “Transfer this key to another website”. Enter the URL of your WHMCS installation as the URL.
• Then please enter the API key, Restricted Keys start with “rk_”, in the module configuration.
• In the Stripe Dashboard, please click on the “Webhooks” tab under “Developer” to create a webhook for the module.
• Under “Hosted endpoints”, please click on “Add endpoint”
• Enter the URL for the callback file as the URL, for example https://ihredomain.de /modules/gateways/callback/pl_stripe_payment.php
• Activate the following events for the webhook: payment_intent.succeeded, payment_intent.payment_failed and payment_intent.processing
• Then click on the webhook you have created in the Stripe dashboard and click on “Show secret key for signature” to display the webhook secret, which you should store in the module configuration.
• If you would like to have the transaction fees calculated so that they are taken into account in WHMCS, please enter your fees in the fields provided for this purpose
• The language files are located in the modules/gateways/NAME_DES_GATEWAYS/lang/ directory and can be customized and supplemented with additional languages
• If you want to change the image that is displayed on the HTML view of the invoice, please replace the .png file from the gateway directory. Please make sure to upload the image in the size in which it is to be displayed.

To be able to guarantee the function, please do not rename any folder or file of the payment gateway.

Update Notes

Update to version 2.0.0

With version 2.0.0, the gateway now uses the newer Payment Intent API from Stripe.com. If you update to version 2.0, please upload the new gateway files to your WHMCS installation and go to the gateway settings in the WHMCS admin area. There are now 2 new settings fields: Webhook Live Secret and Webhook Test Secret. The Webhook Secret can be found in the Stripe Dashboard. To do this, click on “Developer” and then on Webhooks. Then click on the webhook you have already created and click on “Show” for the secret key for signature. Then save this key in the gateway settings. As with the private and public keys, the test mode has its own key which you will receive when you switch your Stripe Dashboard to test mode.
Once you are in the Webhook settings, please click on the 3 dots and then click on Update Details.
Delete all previously active events and select only payment_intent.succeeded, payment_intent.payment_failed and payment_intent.processing and save the settings..

Note: The purpose can now only be 22 characters. Anything over that will be truncated.