Difference between revisions of "SlimPay"

From WHMCS Documentation

(Activation)
(About this Module)
 
(4 intermediate revisions by the same user not shown)
Line 1: Line 1:
 +
== About this Module ==
 +
 +
<div class="docs-alert-danger">
 +
We added this module in WHMCS 7.2 and removed it in WHMCS 8.8.
 +
</div>
 +
 +
SlimPay is a Direct Debit payment gateway supporting both BACS Direct Debit for UK based customers and SEPA for EU based customers. Direct Debit is a pull-based bank-to-bank payment method: a customer authorises a merchant to automatically debit their bank account of the amount of the subscription.
 +
 +
<div class="docs-alert-warning">
 +
Direct debit is not an instant payment service. Payment processing may require multiple days.
 +
</div>
 +
 +
[[File:Slimpay-invoice.png|center]]
 
{{gateways
 
{{gateways
 
| onetime = yes
 
| onetime = yes
Line 6: Line 19:
 
}}
 
}}
  
<div class="docs-alert-info"><i class="fa fa-question-circle"></i> This page describes a feature available in version 7.2 and above</div>
+
== Adding the SlimPay Payment Gateway ==
 +
 +
To set up the SlimPay payment gateway in WHMCS:
 +
 +
# Go to the appropriate location for your version of WHMCS:
 +
#* For WHMCS 8.0 and later, go to '''Configuration (<i class="fa fa-wrench" aria-hidden="true"></i>) > Apps & Integrations''' or '''Addons > [[Apps and Integrations|Apps & Integrations]]'''.
 +
#* For WHMCS 7.10 and earlier, go to '''Setup > Products/Services > [[Payment Gateways]]''' and choose '''All Payment Gateways'''.
 +
# Click '''SlimPay'''.
 +
# Check '''Show on Order Form''' to display this payment method in the Client Area during checkout.
 +
# Enter your SlimPay credentials.
 +
# Click '''Save Changes'''.
 +
# In SlimPay, set the return URL to <tt>https://www.example.com/path/to/whmcs/modules/gateways/callback/slimpay.php</tt>, where <tt>https://www.example.com/path/to/whmcs/</tt> is the URL to your WHMCS installation.
  
SlimPay is a Direct Debit payment gateway supporting both BACS Direct Debit for UK based customers and SEPA for EU based customers.
+
<html><a href="https://www.youtube.com/watch?v=L0B6KbPaGKE&hd=1" class="docs-video-tutorial"><em>Watch the video tutorial for this feature</em><span>&nbsp;<img src="https://assets.whmcs.com/icons/youtube.png">&nbsp;</span></a></html>
  
==What is Direct Debit?==
+
=== Test Mode ===
  
Direct Debit is a pull-based bank-to-bank payment method: a customer authorises a merchant to automatically debit their bank account of the amount of the subscription.
+
You can use [https://dev.slimpay.com/hapi/login?signup sandbox mode] to simulate payment processing without actually causing a transaction to occur. This can be useful to test your configuration.
  
==Payment workflow==
+
=== Instant Activation for New Orders ===
 
 
The first time a user pays an invoice using the SlimPay payment gateway, they will be asked to complete a mandate that authorizes you (the merchant) to debit their bank account automatically each subscription cycle. The customer only has to do this once.
 
 
 
[[File:Slimpay-mandate-success.png|center]]
 
 
 
 
 
Upon creation of a mandate for the first time, a payment request will be initiated. Until such time as the payment has fully completed, the invoice will display a "Payment Pending" status and display a message to the user as shown below. No automated provisioning actions will be performed until the payment has fully cleared, unless you enable the Instant Activation for New Orders option.
 
 
 
<div class="docs-alert-warning">Direct debit is not an instant payment service. Payments can take up to a few days to clear and fully complete processing.</div>
 
 
 
[[File:Slimpay-invoice.png|center]]
 
  
 +
Direct debit is not an instant payment service. Payments can take up to a few days to clear and fully complete processing.
  
For recurring invoices where a mandate agreement already exists between you and the customer, WHMCS will automatically request a payment capture on the due date of the invoice.
+
If you wish to provision new orders immediately upon the completion of a mandate agreement and initiating of a payment, to avoid the customer having to wait while the payment clears, check '''Instant Activation for New Orders''' in the SlimPay payment gateway settings. This will trigger the invoice to be marked paid and any successful payment automation actions to be carried out immediately.
  
==Supported Currencies==
+
=== Supported Currencies ===
  
 
SlimPay supports payments in Euro and British Pounds. The module will automatically select the appropriate BACS or SEPA payment method based on the currency of the invoice.
 
SlimPay supports payments in Euro and British Pounds. The module will automatically select the appropriate BACS or SEPA payment method based on the currency of the invoice.
  
==Activation==
+
== Payment Workflow ==
  
Navigate to '''Configuration (<i class="fa fa-wrench" aria-hidden="true"></i>) > System Settings > Payment Gateways''' or, prior to WHMCS 8.0, '''Setup > Payments > Payment Gateways'''. Select the All Payment Gateways tab. Now click the SlimPay button to activate it.
+
The first time a user pays an invoice using the SlimPay payment gateway, they will be asked to complete a mandate that authorizes you (the merchant) to debit their bank account automatically each subscription cycle. The customer only has to do this once.
  
You will be prompted for your SlimPay App ID, Secret and Creditor Reference which should have been provided to you by SlimPay.
+
[[File:Slimpay-mandate-success.png|center]]
  
<html><a href="https://www.youtube.com/watch?v=L0B6KbPaGKE&hd=1" class="docs-video-tutorial"><em>Watch the video tutorial for this feature</em><span>&nbsp;<img src="https://assets.whmcs.com/icons/youtube.png">&nbsp;</span></a></html>
+
Upon creation of a mandate for the first time, a payment request will be initiated. Until such time as the payment has fully completed, the invoice will display a "Payment Pending" status and display a message to the user as shown below. No automated provisioning actions will be performed until the payment has fully cleared, unless you enable the Instant Activation for New Orders option.
  
==Notification/Returns URLs==
+
For recurring invoices where a mandate agreement already exists between you and the customer, WHMCS will automatically request a payment capture on the due date of the invoice.
  
The Return URL inside your SlimPay account should be set to the following:
+
=== Rejected Payments ===
 
 
https://www.yourdomain.com/path/to/whmcs/modules/gateways/callback/slimpay.php
 
 
 
==Instant Activation for New Orders==
 
 
 
Direct debit is not an instant payment service. Payments can take up to a few days to clear and fully complete processing.
 
 
 
If you wish to provision new orders immediately upon the completion of a mandate agreement and initiating of a payment, to avoid the customer having to wait while the payment clears, you can check the "Instant Activation for New Orders" option in the SlimPay payment gateway settings and this will trigger the invoice to be marked paid and any successful payment automation actions to be carried out immediately.
 
 
 
==Rejected Payments==
 
  
 
The SEPA scheme allows an eight week period where a payment received can be rejected or reversed by the payee. WHMCS will monitor for any changes in the payment status of invoices paid via SlimPay during this time and will automatically process these as appropriate.
 
The SEPA scheme allows an eight week period where a payment received can be rejected or reversed by the payee. WHMCS will monitor for any changes in the payment status of invoices paid via SlimPay during this time and will automatically process these as appropriate.
  
To learn more, visit [[Payment Reversals]]
+
For more information, see [[Payment Reversals]].
 
 
==Sandbox==
 
  
SlimPay have a sandbox for testing the payment integration. You can apply for sandbox credentials here: https://dev.slimpay.com/hapi/login?signup
+
==Troubleshooting==
  
 +
''N/A''
  
 
{{modules}}
 
{{modules}}

Latest revision as of 18:13, 27 July 2023

About this Module

We added this module in WHMCS 7.2 and removed it in WHMCS 8.8.

SlimPay is a Direct Debit payment gateway supporting both BACS Direct Debit for UK based customers and SEPA for EU based customers. Direct Debit is a pull-based bank-to-bank payment method: a customer authorises a merchant to automatically debit their bank account of the amount of the subscription.

Direct debit is not an instant payment service. Payment processing may require multiple days.

Slimpay-invoice.png

Supported Features

Type One Time Recurring Refunds Reversals
3rd Party Yes Yes Yes

Yes


Adding the SlimPay Payment Gateway

To set up the SlimPay payment gateway in WHMCS:

  1. Go to the appropriate location for your version of WHMCS:
    • For WHMCS 8.0 and later, go to Configuration () > Apps & Integrations or Addons > Apps & Integrations.
    • For WHMCS 7.10 and earlier, go to Setup > Products/Services > Payment Gateways and choose All Payment Gateways.
  2. Click SlimPay.
  3. Check Show on Order Form to display this payment method in the Client Area during checkout.
  4. Enter your SlimPay credentials.
  5. Click Save Changes.
  6. In SlimPay, set the return URL to https://www.example.com/path/to/whmcs/modules/gateways/callback/slimpay.php, where https://www.example.com/path/to/whmcs/ is the URL to your WHMCS installation.

Watch the video tutorial for this feature  

Test Mode

You can use sandbox mode to simulate payment processing without actually causing a transaction to occur. This can be useful to test your configuration.

Instant Activation for New Orders

Direct debit is not an instant payment service. Payments can take up to a few days to clear and fully complete processing.

If you wish to provision new orders immediately upon the completion of a mandate agreement and initiating of a payment, to avoid the customer having to wait while the payment clears, check Instant Activation for New Orders in the SlimPay payment gateway settings. This will trigger the invoice to be marked paid and any successful payment automation actions to be carried out immediately.

Supported Currencies

SlimPay supports payments in Euro and British Pounds. The module will automatically select the appropriate BACS or SEPA payment method based on the currency of the invoice.

Payment Workflow

The first time a user pays an invoice using the SlimPay payment gateway, they will be asked to complete a mandate that authorizes you (the merchant) to debit their bank account automatically each subscription cycle. The customer only has to do this once.

Slimpay-mandate-success.png

Upon creation of a mandate for the first time, a payment request will be initiated. Until such time as the payment has fully completed, the invoice will display a "Payment Pending" status and display a message to the user as shown below. No automated provisioning actions will be performed until the payment has fully cleared, unless you enable the Instant Activation for New Orders option.

For recurring invoices where a mandate agreement already exists between you and the customer, WHMCS will automatically request a payment capture on the due date of the invoice.

Rejected Payments

The SEPA scheme allows an eight week period where a payment received can be rejected or reversed by the payee. WHMCS will monitor for any changes in the payment status of invoices paid via SlimPay during this time and will automatically process these as appropriate.

For more information, see Payment Reversals.

Troubleshooting

N/A

Server Modules
cPanel/WHM - DirectAdmin - Plesk - Helm 3 - Helm 4 - Ensim - InterWorx - WebsitePanel - Cloudmin
Lxadmin - Virtualmin Pro - XPanel - HyperVM - SolusVM - Cloudmin - WHMSonic - VPS.Net
CentovaCast - SCPanel - MediaCP - GameCP - TCAdmin - Reseller Central - Auto Release - Heart Internet

Registrar Modules
Enom - ResellerClub - Nominet - OpenSRS - ResellOne - OnlineNIC - PlanetDomain - Affordable Domains
TPP Wholesale - TPPInternet - Stargate - Namecheap - NetEarthOne - Bizcn - InternetBS - GMO Internet
12Register - Registercom - DotDNS - WebNIC - Dot.TK - HexoNet - Realtime Register - Registereu
RRPProxy - ResellerCamp - TransIP - Heart Internet - IPMirror - NetRegistry - OVH - VentraIP Wholesale
Email - 101Domain

Fraud Modules
MaxMind - VariLogiX FraudCall - Telesign

Gateway Modules
2CheckOut - AsiaPay - Auth.net Echeck - Authorize.net - Authorize.net CIM - Bank Transfer - BidPay
BluePay - BluePay Echeck - BluePay Remote - Boleto - CashU - CC Avenue - ChronoPay - Direct Debit
EMatters - E-Path - eProcessingNetwork - eWAY Tokens - F2B - Finansbank - GarantiBank - Gate2Shop
Inpay - InternetSecure - IP.Pay - Kuveytturk - Modulo Moip - Mail In Payment - Merchant Partners
Merchant Warrior - IDEALMollie - Moneris - Moneris Vault - Skrill 1-Tap - NaviGate - NETbilling
Netregistry Pay - NoChex - Offline Credit Card - Optimal Payments - PagSeguro - Payflow Pro - Pay Junction
Paymate AU and NZ - Payment Express - PayPal - PayPal Card Payments - PayPal Express Checkout
PayPal Payments - PayPal Payments Pro - PayPoint.net (SecPay) - Payson - Planet Authorize - ProtX VSP Form
PSIGate - Quantum Gateway - Quantum Vault - SagePay - SagePay Tokens v2 - SecurePay
SecurePay AU - Secure Trading - TrustCommerce - USA ePay - WorldPay - WorldPay Invisible