How Do I Setup Payment Gateways?
Each gateway that you create will have requirements for their particular API. However, they’ll all have three main things in common:
Visible name – This is what the gateway is called and what’s shown to visitors, as well as everywhere else within the system. For example, a gateway might have the visible name of Credit Card but it’s actually Authorize.net
Show on order form – If you select this option, you can choose to display when a user visits the order page, provided it isn’t restricted for that group gateway
Convert to for processing – In some cases, you might have certain gateways that accept different currencies and some that don’t. That’s what this option is for. It’ll send the correct currency, according to what you have setup in Currencies (Under Setup > Payments)
Below are the gateways you’ll have available in WHMCS by default.
Merchant gateways will securely keep customer credit card information inside WHMCS.
Offline Credit Card
PayPal Payments Pro
WorldPay Invisible XML
Third Party Gateways
Third party gateways will require customers to visit the gateway’s site to process their payment.
Cobrança – F2b
iDEAL via Mollie
Mail In Payment
PayPal Express Checkout
ProtX VSP Form
Turkish Garanti Bank
Tokenisation gateways will offer easy repeat billing, but they won’t store the customer’s credit card information. The transaction details are used instead, or reference numbers.
This means you don’t have as much PCI liability. But customers will need to manually pay the invoice, providing their credit card number to the gateway company. The gateway will then send a token to WHMCS to be used in customer accounts and for repeat billing.
|PayPal Pro Reference Payments
Note: You can customize invoice payment instructions. The email template used depends on the gateway you choose. Third Party Gateways send the template named Invoice Created. Tokenisation and Merchant Gateways send the template named Credit Card Invoice Created.
Note: Attempt Captures is disabled for Third Party Gateways. For other types of gateways you can use the Attempt Capture feature to try to instantly capture a client’s payment from their credit card.
Note: If a gateway is shown in blue, you can click on it to get more information about it.
These are just the default payment gateways. If you’d rather use something not listed, you should refer to WHMCS developer resources section.
Run a Test Transaction
You can run a test transaction to make sure everything is setup correctly by using test credit card numbers listed below (expiration dates can be anything in the future):
4007000000027 – Visa Test Card
4012888818888 – Visa Test Card II
4000000000000002 – Visa Test Card III
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)