Difference between revisions of "Quantum Gateway"

From WHMCS Documentation

(Adding the Quantum Gateway Payment Gateway)
 
(5 intermediate revisions by the same user not shown)
Line 1: Line 1:
==Overview==
+
== About this Module ==
  
Quantum Gateway is a merchant gateway solution that supports 3D Secure for Visa & MasterCard Transactions in WHMCS.
+
[http://www.whmcs.com/partners/quantum-gateway/ Quantum Gateway] is a merchant gateway solution that supports 3D Secure for Visa and MasterCard transactions in WHMCS.
 
 
If you don't yet have an account, visit [http://www.whmcs.com/partners/quantum-gateway/ www.whmcs.com/partners/quantum-gateway/] for more information.
 
 
 
==Setup==
 
 
 
*You must use your Quantum gateway login id as your username
 
*If you don't have your '''RestrictKey''', you can easily generate it by login into your Quantum Gateway merchant center and going to the Processing settings area. Scroll down until you see the "RestrictKey" area. Click the generate button, check the "Use restriction key" box, and finally click the UPDATE button. That is your new restriction key (Transaction Key).
 
 
{{gateways
 
{{gateways
 
| type = cc
 
| type = cc
Line 16: Line 9:
 
| refunds = yes
 
| refunds = yes
 
}}
 
}}
 +
== Adding the Quantum Gateway Payment Gateway ==
  
==MD5 Hash Verification==
+
To set up the Quantum Gateway payment gateway in WHMCS:
 
+
The MD5 Hash in the Quantum Gateway module is used to prevent forged callback requests. To set this up in your Quantum Gateway Account:
+
# 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]]'''.
* Navigate to ''Configuration > Processing Settings''
+
#* For WHMCS 7.10 and earlier, go to '''Setup > Products/Services > [[Payment Gateways]]''' and choose '''All Payment Gateways'''.
* Scroll down to the '''MD5-Hash''' heading
+
# Click '''Quantum Gateway'''.
* Enter a secret key value of your own choosing in the '''Hash Value''' field.
+
# Check '''Show on Order Form''' to display this payment method in the Client Area during checkout.
* Set the '''Include Response In Hash''' value to "No"
+
# Enter your Quantum Gateway credentials.
* Then enter the same value into your WHMCS installation Quantum Gateway config in '''Setup > Payments > Payment Gateways'''.
+
#* You '''must''' use your Quantum Gateway login ID as your username.
 
+
#* You can generate the '''Restrict Key''' value in the Quantum Gateway merchant center on the '''Processing Settings''' page.  
==Quantum Vault Service==
+
#* To set up the MD5 hash:
 
+
#*# Log in to the Quantum Gateway merchant center.
{{gateways
+
#*# Go to '''Configuration > Processing Settings'''.
| type = token
+
#*# Under '''MD5-Hash''', enter a secret key value for '''Hash Value'''.
| onetime = yes
+
#*# Set '''Include Response in Hash''' to ''No''.
| recurring = yes
+
#*# Enter the same hash value in WHMCS.
| refunds = yes
+
# Click '''Save Changes'''.
| level = 3
 
| updatecc = yes
 
| deletecc = yes
 
}}
 
 
 
The Vault Solution from Quantum Gateway enables you to accept credit cards through your site while completely avoiding the hassles of PCI compliance and here at WHMCS we were one of the first to offer this new service to Quantum users.
 
 
 
For more information visit the [[Quantum Vault]] page
 
 
 
===How does it work?===
 
 
 
#The customer leaves your site to perform 3D Secure authentication (exactly the same as they already do now) but the difference is they enter their card details once they've left your site aswell so that the card details never pass through your site
 
#The customer can still edit their card held on file at any time from the client area
 
#WHMCS can still request the card is rebilled whenever needed meaning fully automated recurring billing can continue as before and manual captures at any time are also still possible - it's just like you have the card details stored locally
 
 
 
===Why does it avoid PCI compliance?===
 
 
 
#No cardholder data ever touches or passes through your Network, Server or WHMCS System
 
#No cardholder data is ever retained or stored on your Network, Server or WHMCS system
 
 
 
===Configuration/Setup===
 
 
 
You will find the module in the '''Setup > Payment Gateways''' area listed as Quantum Vault which you can activate and configure in the same way as the regular module.
 
  
For existing Quantum Gateway users, there is also a '''vault migration script''' available to transfer all your existing clients card details over to the vault automatically and remove them from your local database. It can be downloaded from https://www.whmcs.com/download/117/quantum-vault-migration-utility
+
=== Test Mode === 
  
Inside your Quantum Gateway account, you will need to configure and API Username, Key and Vault Key to use the Vault API, and in the Inline Frame API settings where it asks for various urls, you should leave all of those fields blank.
+
This module does not support test mode.
  
Contrary to what you might think, you should leave the "Disable Credit Card Storage" setting unticked in '''Setup > General Settings > Security''' as that will disable entry by a client.
+
== Troubleshooting ==
  
 +
''N/A''
  
 
{{modules}}
 
{{modules}}

Latest revision as of 19:00, 28 September 2022

About this Module

Quantum Gateway is a merchant gateway solution that supports 3D Secure for Visa and MasterCard transactions in WHMCS.

Supported Features

Type One Time Recurring Refunds 3D Secure
Credit Card Yes Yes Yes Yes

Adding the Quantum Gateway Payment Gateway

To set up the Quantum Gateway 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 Quantum Gateway.
  3. Check Show on Order Form to display this payment method in the Client Area during checkout.
  4. Enter your Quantum Gateway credentials.
    • You must use your Quantum Gateway login ID as your username.
    • You can generate the Restrict Key value in the Quantum Gateway merchant center on the Processing Settings page.
    • To set up the MD5 hash:
      1. Log in to the Quantum Gateway merchant center.
      2. Go to Configuration > Processing Settings.
      3. Under MD5-Hash, enter a secret key value for Hash Value.
      4. Set Include Response in Hash to No.
      5. Enter the same hash value in WHMCS.
  5. Click Save Changes.

Test Mode

This module does not support test mode.

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