Payment Gateways

From WHMCS Documentation

Revision as of 15:01, 14 December 2011 by John (talk | contribs) (Third Party Gateways)

Setting Up Gateway Modules

We have prepared a video tutorial for this section @ http://www.whmcs.com/tutorials.php?i=3

Payment gateways can be configured in Setup > Payment Gateways. Each gateway has their own specific API requirements in order to process transactions so they will vary from gateway to gateway. However, all gateways have 3 core options:

  • Show on Order Form – Checking this box will mean it can be shown on the order form as an option – subject to product group gateway restrictions
  • Visible Name – The name that is used for this gateway throughout the system and to clients (eg. gateway can be Authorize.net, visible name might be Credit Card)
  • Convert To For Processing – This option is for when using multiple currencies. It is possible that not every gateway you use will accept all the currencies you offer on your site and so for those that don’t, you can choose a currency here for WHMCS to convert to before sending to them. For example if using Google Checkout with a UK account but offering prices in GBP & USD, you would need to select GBP in the Convert To box. This will use the rates set in Config > Currencies to do the conversion which can be set to auto update daily.

Supported Gateway Modules

The following is a list of all the payment gateways that are included in WHMCS by default. Merchant Gateways store credit card information securely in the WHMCS database whilst Third Party Gateways take the client to the provider's website to process payments off-site. Tokenisation Gateways are a happy medium where repeat billing is possible by storing the original transaction details or a reference number, not the full credit card number, thus reducing your PCI liabilities.

Any gateways showing in blue below indicates further information relating to the setup & use of that gateway is available by clicking on the name.

It is also possible to create your own gateway modules for WHMCS should you want to integrate with a gateway that isn't offered by default. Please refer to our Developer Resources section for more details.

Merchant Gateways

AsiaPay Authorize.net BluePay
CamTech Cyberbit eMatters
eProcessingNetwork eWay FastHosts
IMSP InternetSecure IP.Pay
Kuveytturk Bank LinkPoint Merchant Partners
Moneris Merchant Warrior NaviGate
NETbilling Netregistry Pay NTPNow
Offline Credit Card OpenECHO Optimal Payments
Payflow Pro Pay Junction PayPal Payments Pro
Planet Authorize PSIGate Quantum Gateway
Sagepay SecPay SecurePay
SecurePay AU TrustCommerce USA ePay
WorldPay Invisible WorldPay Invisible XML

Tokenisation Gateways

Authorize.net CIM Bluepay Remote Moneris Vault
PayPal Pro Reference Payments Quantum Vault WorldPay FuturePay

Third Party Gateways

2CheckOut ACHDirect AlertPay
Amazon Simple Pay Authorize.net Echeck Bank Transfer
BidPay BluePay Echeck Boleto
CC Avenue CashU ChronoPay
Cobrança - F2b E-Gold e-Path
Gate2Shop Google CheckOut iDEAL
iDEAL via Mollie inpay Kuveytturk Bank
Liberty Reserve Mail In Payment Moneybookers
NoChex PagSeguro Pay Offline
PayPal PayPal Express Checkout Paymate
Paymate NZ Payment Express Paymex
Payson PlanetAuthorize ProtX VSP Form
StormPay Turkish Finansbank Turkush Garanti Bank
WorldNet WorldPay

Deactivating Gateway Modules

Deactivate Gateway

Should you no longer wish to use a particular payment gateway clicking the red (Deactivate) link beside the name will gracefully remove the gateway from the system. This will prevent any further payments being made using this gateway and automatically reassign any products/services/invoices assigned to that payment method to another option. Upon clicking the deactivate link, a popup window will appear prompting for the selection of the alternative payment gateway to which any currently assigned items should be changed to.

Test Credit Card Numbers

Gateways often have test modes where you can use test card numbers. The common test card numbers are below and should generate successful test transactions but they can vary from gateway to gateway. You may use any expiration date in the future.

4007000000027 - Visa Test Card
4012888818888 - Visa Test Card II
5424000000000015 - MasterCard Test Card
370000000000002 - American Express Test Card
6011000000000012 - Discover Test Card
3088000000000017 - JCB Test Card (Use expiration date 0905)
38000000000006 - Diners Club/Carte Blanche Test (Use expiration date 0905)