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.3 – 8.8 installation
- Admin access to WHMCS
- Installed Ioncube Loader (at least version 12)
- Active account at stripe.com with corresponding activated payment method
- PHP 7.4 & 8.1
Installation
- Please upload the module files to your web space and then activate the gateway in the admin area of WHMCS.
- Then please enter the API Keys. You can find the keys in the Stripe.com Dashboard.
- The data for the webhook secret can be found in the Stripe Dashboard after you have created the webhook in the Stripe Dashboard.
- Log in to the Stripe.com Dashboard and create a webhook there on the file: https://yourdomain.de /modules/gateways/callback/pl_stripe_payment.php
- Activate the following events on the webhook: payment_intent.succeeded, payment_intent.payment_failed and payment_intent.processing.
- If you want to have the transaction fees calculated so that they are taken into account in WHMCS, please enter your fees in the fields provided.
- The language files are located in the directory modules/gateways/NAME_DES_GATEWAYS/lang/ and can be individually adapted and supplemented with further 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.