Stripe SEPA Payments For WHMCS
|Stripe SEPA Payments For WHMCS has been designed in order to boost your payment capabilities by implementing Stripe payment gateway to your WHMCS system.|
Thanks to this module, you will be able to secure SEPA Direct Debit payments from your clients, handle recurring deals and perform refunds.
- Payment Gateway:
|✔ Accept SEPA (Single Euro Payments Area) Direct Debits Payments|
|✔ Collect IBAN Number To Debit Customer Payments|
|✔ Attempt Payment Captures From Customer Bank Account|
|✔ Enter Company Name To Be Used In Mandate Authorization|
|✔ Display Payment Capture Notification In Invoice Creation Emails And PDF Invoices|
|✔ One-Time And Recurring Payments Support|
|✔ Refund Transaction|
- Client Area:
|✔ Provide Bank Account Details On Order Checkout|
|✔ Full Name|
|✔ IBAN Number|
|✔ Edit Bank Details In Account Menu|
|✔ Read And Accept Mandate For Debit Authorization|
|✔ Delete Mandate|
- Addon Module:
|✔ View Invoice Status|
|✔ View Capture Status|
|✔ View Mandate|
|✔ Payment ID|
|✔ View Seller Message|
|✔ View Charge Status|
|✔ View Integration Code|
- Supported Currencies:
|✔ Euro - Default Payment Currency|
|✔ Other Currencies - Will Be Automatically Converted To Euro|
- General Info:
|✔ Supports PHP 5.6 Up To PHP 7.2|
|✔ Supports WHMCS Template Six|
|✔ Supports WHMCS V7.2 And Later|
Installation and Configuration
|This tutorial will show you how to successfully install and configure Stripe SEPA Payments for WHMCS.|
We will guide you step by step through the whole installation and configuration process.
|1. Log in to our client area and download the module.|
|2. In the downloaded file you will find two packages that support different PHP versions.|
As presented on the screen below, the first one is dedicated to PHP 5.6 up to PHP 7.0, while the second one is aimed at PHP 7.1 up to PHP 7.2.
It does not apply to open source versions.
Note: You can check the current PHP version in your WHMCS. To do so, proceed to 'Utilities' › 'System' › 'PHP Info'.
|3. Extract the downloaded file and choose the one with the right PHP version. Upload and extract the PHP file into the main WHMCS directory.|
The content of PHP version files should look like this.
|4. When you install Stripe SEPA Payments For WHMCS for the first time you have to rename 'license_RENAME.php' file.|
You can find it in 'modules/addons/stripesepa/license_RENAME.php'. Rename it from 'license_RENAME.php' to 'license.php'.
|5. In order to configure your license key, you have to edit the previously renamed 'license.php' file.|
Enter your license key between quotation marks as presented on the following screen. You can find your license key in our client area → 'My Products'.
Activation of Addon
|6. Now you have to activate the module in your WHMCS system. |
Log in to your WHMCS admin area. Go to 'Setup' → 'Addon Modules'. Afterward, find 'Stripe SEPA Payments' and press the 'Activate' button.
|7. In the next step you need to permit access to this module.|
To do so, click on the 'Configure' button, tick the checkboxes to assign desired admin roles.
Company Name - enter the company name, it will appear during the acceptance. Click here to see the screenshot.
|8. The 'Integration' page contains three different codes required to create custom messages on invoices.|
Note: The integration code path may vary depending on the template you are using.
|The first code allows you to display the charges on the Invoice Created email.|
This is how your edited template should look like.
|If the code has been typed in correctly, the sample Invoice Created email should include the following element.|
|The second one is responsible for adding the charges on a PDF invoice linked to the Invoice Created email.|
|Thanks to the final code, you can display the charges on the preview of an invoice. See the picture below.|
| Note: The added sections will appear on all the HTML and PDF invoices if they still have the 'Pending Payment' status.|
Once the invoice is paid, the additional pieces of information will no longer appear.
|You can now access your module under 'Addons' → 'Stripe SEPA Payments'.|
Configuration of Webhook
|9. Now you have to configure the webhook in your WHMCS system.|
Open your Stripe dashboard and navigate to API → Webhooks.
|Click 'Add Endpoint' .|
|Now, enter the full URL to your Stripe callback PHP file. For example:
And click the 'Add endpoint' button once more.
|Once a new endpoint is successfully created, copy your recently generated Signing Key for future use.|
Configuration of Gateway
|10. Now you have to activate the gateways in your WHMCS system.|
Log in to your WHMCS admin area. Go to 'Setup' → 'Payments' → 'Payment Gateways'.
|11. Afterward, configure your new gateway's settings. Check 'Show on Order Form' and rename it if you wish.|
Stripe SEPA Payments:
Important: EUR currency needs to be pre-configured in your WHMCS currencies settings in order to use the module correctly.
|12. You have just successfully installed and configured Stripe SEPA Payments!|
|In this section we will show you the possibilities of Stripe SEPA Payments For WHMCS.|
Collect SEPA Direct Debit payments from your clients using the Stripe gateway.
Setting Bank Details
|First, log in as a client and navigate to the Edit Bank Details tab.|
|Enter account details, then click on Save Account Details.|
Module will validate IBAN and if it turns out to be invalid, a special message will be displayed and user will not be able to set it.
|Now, make sure to check the box marked on the screen and press Accept Mandate.|
|Stripe SEPA Payments For WHMCS is generally used to pay invoices for placed orders. In order to illustrate its functionalities we have placed an exemplary order.|
As you can see on the below screenshot, apart from the Stripe SEPA there are other gateways available as well.
|Note that only the last four digits of IBAN will be displayed.|
|As a confirmation of your payment you will see the following screen.|
|Once your payment has been registered, the processing time may last from a couple of hours up to a few days.|
Within that period the invoice will remain marked as Pending Payment
|If you want to pay an unpaid invoice, then view that invoice, choose the payment method and press 'Pay Now'.|
|Stripe SEPA addon additionally allows you to track the history of payments, their Charge Status and view your mandate.|
|Note: All payments here are displayed in Euro currency. Even if a customer paid using a different currency, the amount will be displayed in Euro after currency conversion.|
|1. If you do not want to let your clients choose between payment methods when purchasing some products, unselect this payment option for the group of products in its details.|
|2. If logs are enabled you can see detailed info about each Stripe API call. You can find them in 'Utilities' → 'Logs' → 'Module Logs' in your WHMCS admin area.|
|3. Stripe SEPA Payments For WHMCS module besides single and recurring payments fully supports refunds functionality.|
If you need to quickly refund a transaction then just use the built-in refunds section in an invoice details site to refund a given payment straight to a customer bank account.
Click here to read the detailed explanation devoted to Refunds.
|4.If cron is configured in WHMCS, then once a day, the module will check every invoice in search of unpaid Stripe SEPA invoices with the due date less than or equaling to today's date. |
Subsequently, the module will attempt to charge clients based on these invoices.
|Essential guidance through the process of updating the module is offered here.|
Keep in mind there is a quick and easy option in our client area that will let you upgrade the license of your module to an open source version at any time - and at a lower price!
|1. When you have problems with connection, check whether your SELinux or firewall does not block ports.|
|2. If you encounter any problems with making a payment, please refer to 'Billing' → 'Gateway Log' for detailed information.|
|3. The stripe icon has been removed from the "Edit Bank Details" option in WHMCS V7.6 due to broken implementation of Font Awesome 5.|