Stripe SEPA Payments For WHMCS

From ModulesGarden Wiki
Jump to: navigation, search

Contents

About Stripe SEPA Payment Gateway 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
✔ Address
✔ 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

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.

Installation

1. Log in to our client area and download the module.
SSP 2 1.png
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'.

PHP56 72.png
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.

SSP 1 2.png
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'.

SSP 2.png
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'.

SSP 2 1 1.png

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.

SSP 5.png
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.
Access Control - select admin groups that will have access to your module.
Now, press 'Save Changes'.

SSP 6.png

Integration Code

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.

SSP 21.png
The first code allows you to display the charges on the Invoice Created email.
This is how your edited template should look like.
SSP 21 1.png
If the code has been typed in correctly, the sample Invoice Created email should include the following element.
SSP 22.png
The second one is responsible for adding the charges on a PDF invoice linked to the Invoice Created email.
SSP 23.png
Thanks to the final code, you can display the charges on the preview of an invoice. See the picture below.
SSP 24.png
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.
Do not forget to copy both your Publishable and Secret keys as they will come in handy later on.

SSP 31.png
Click 'Add Endpoint' .
SSP 41.png
Now, enter the full URL to your Stripe callback PHP file. For example:
https://www.examplesite.com/modules/gateways/callback/stripesepa.php

And click the 'Add endpoint' button once more.
Note: You can validate your URL by sending test calls to previously configured Webhook and checking Module Log in your WHMCS

SSP 42.png
Once a new endpoint is successfully created, copy your recently generated Signing Key for future use.
SSP 43.png

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'.
Activate the 'Stripe SEPA Payments' gateway.

SSP 3.png
11. Afterward, configure your new gateway's settings. Check 'Show on Order Form' and rename it if you wish.

Stripe SEPA Payments:

  1. Display Name - name of the gateway that appears after selecting it during the checkout
  2. Publishable Key - enter your previously generated publishable key
  3. Secret Key- enter your secret key here (see step 8.)
  4. Signing Key - enter the signing key for webhook here
  5. Base Auth Login - enter the base authorization login in case your site uses one
  6. Base Auth Password - enter the base authorization password if your site requires it
  7. Select EUR currency to convert to if you are using other currencies!

Important: EUR currency needs to be pre-configured in your WHMCS currencies settings in order to use the module correctly.
Payments made in other currencies through this gateway will be automatically converted into Euro at a specified conversion rate.

Save the changes when ready

SSP 4.png
12. You have just successfully installed and configured Stripe SEPA Payments!

Management

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.
SSP 6 12.png
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.

SSP 71.png
Now, make sure to check the box marked on the screen and press Accept Mandate.
SSP 72.png

Performing Payment

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.
Check 'Stripe SEPA Payments' and complete the order.

SSP 6 1.png
Note that only the last four digits of IBAN will be displayed.
SSP 7.png
As a confirmation of your payment you will see the following screen.
SSP 7 1.png
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

SSP 7 121.png
If you want to pay an unpaid invoice, then view that invoice, choose the payment method and press 'Pay Now'.
SSP 8.png
Stripe SEPA addon additionally allows you to track the history of payments, their Charge Status and view your mandate.
SSP 117.png
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.

Tips

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.
SSP 13.png
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.

Update Instructions

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!
To take advantage of it, simply use the License Upgrade button located on the product's page and a discounted invoice will be generated automatically.

Common Problems

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.
Personal tools
Namespaces

Variants
Actions
Navigation
WHMCS Modules
cPanel Modules
Magento Extensions
Magento Themes
PrestaShop Modules
Blesta Extensions
General
Social
Stripe SEPA Payments For WHMCS