Difference between revisions of "EWAY"

From WHMCS Documentation

(Creating eWAY Configuration Data)
Line 1: Line 1:
<div class="docs-alert-info"><i class="fa fa-question-circle"></i> This page describes features available in version 7.9 and above</div>
+
<div class="docs-alert-info">We added this module in WHMCS 7.9. It supersedes the [[EWAY Rapid 3.1]] module.</div>
  
This module supersedes the [[EWAY Rapid 3.1]] module.
+
eWAY lets WHMCS users to accept online credit card payments easily and securely so they can grow their business fast. The Secure Fields solution allows merchants to securely and seamlessly process payments from their own website, without exposing the sensitive card data.
 +
 
 +
<div class="docs-alert-info">[https://my.eway.io/whmcs Create an eWAY Account]</div>
 +
 
 +
Further, the WHMCS integration takes advantage of Token Payments, allowing customers to securely store the card information within eWAY’s PCI DSS environment, and WHMCS uses the Token (which represent the saved card) to handle all future payments without the customer having to key in their details again.
 
{{gateways
 
{{gateways
 
| type = token
 
| type = token
Line 10: Line 14:
 
}}
 
}}
  
eWAY lets WHMCS users to accept online credit card payments easily and securely so they can grow their business fast.
+
== Adding the EWAY Payment Gateway ==
 
+
eWAY’s Secure Fields solution allows merchants to securely and seamlessly process payments from their own website, without exposing the sensitive card data.
+
To set up the EWAY payment gateway in WHMCS:
 
+
Further, the WHMCS integration takes advantage of Token Payments, allowing customers to securely store the card information within eWAY’s PCI DSS environment, and WHMCS uses the Token (which represent the saved card) to handle all future payments without the customer having to key in their details again.
+
# Go to '''Configuration (<i class="fa fa-wrench" aria-hidden="true"></i>) > System Settings > [[Payment Gateways]]''' or, prior to WHMCS 8.0, '''Setup > Products/Services > Payment Gateways'''.
 +
# Choose the '''All Payment Gateways''' tab.
 +
# Click '''EWAY'''.
 +
# Check '''Show on Order Form''' to display this payment method in the Client Area during checkout.
 +
# Create and enter your EWAY credentials:
 +
## Create an [https://my.eway.io/whmcs eWay account].
 +
## Log in to the [https://my.eway.io MYeWAY Dashboard].
 +
## Go to '''My Account > API Key'''.
 +
## Copy and paste your API key and password into WHMCS. For information on setting up your API key and password, see the [https://go.eway.io/s/article/How-do-I-setup-my-Live-eWAY-API-Key-and-Password eWAY Knowledge base.].
 +
## Copy and paste your public API key ('''Pay Now Button Public API key''') into WHMCS. For information on obtaining your Public API Key, see [https://go.eway.io/s/article/How-do-I-find-my-Public-API-Key Finding my Public API Key]
 +
# Click '''Save Changes'''.
  
 
===Test Mode===
 
===Test Mode===
  
Allows you to test certain aspects of your WHMCS integration with the eWAY Sandbox. The eWAY Sandbox by default will provide a successful result for any valid transaction request. If you wish to test declined transactions, then you will want to change your Sandbox Settings from "Always Approved" to "Always Decline".
+
You can use test mode to simulate payment processing without actually causing a transaction to occur. This can be useful to test your configuration.
  
===Creating eWAY Configuration Data===
+
===Migrating to eWAY from eWAY Rapid 3.1===
  
To accept online payments eWAY uses an API key and password along with a Public API Key to connect to WHMCS. For a detailed guide on setting up your API key and password, visit the [https://go.eway.io/s/article/How-do-I-setup-my-Live-eWAY-API-Key-and-Password eWAY Knowledge base.]. A detailed guide on obtaining your Public API Key can be found on [https://go.eway.io/s/article/How-do-I-find-my-Public-API-Key Finding my Public API Key]
 
 
To connect your store to eWAY, it only requires a few simple steps.
 
 
#Create an [https://my.eway.io/whmcs eWay account].
 
#Log in to the [https://my.eway.io MYeWAY Dashboard].
 
#Navigate to '''My Account > API Key'''.
 
#Copy and paste your '''API Key''' and '''API Password''' into WHMCS
 
#Copy and paste your '''Public API Key''', labeled as '''Pay Now Button Public API key''', into WHMCS.
 
 
<div class="docs-alert-info">'''Still need help to configure eWAY?''' Call +61 2 6175 3000 to speak with eWAY now.</div>
 
 
===Migrating to eWAY from eWAY Rapid 3.1===
 
 
The eWAY Rapid 3.1 module included in previous versions of WHMCS can be easily replaced with the eWAY module.
 
The eWAY Rapid 3.1 module included in previous versions of WHMCS can be easily replaced with the eWAY module.
 
If the WHMCS installation has existing tokens stored from the previous module, a button will be shown on the Payment Gateways configuration page to swiftly migrate the tokens to the new module.
 
If the WHMCS installation has existing tokens stored from the previous module, a button will be shown on the Payment Gateways configuration page to swiftly migrate the tokens to the new module.
Line 51: Line 52:
 
<div class="docs-alert-info"><i class="fa fa-question-circle"></i> The Migrate to eWAY Module will only show if the WHMCS installation has Payment Methods associated with the eWAY Rapid Payments module.</div>
 
<div class="docs-alert-info"><i class="fa fa-question-circle"></i> The Migrate to eWAY Module will only show if the WHMCS installation has Payment Methods associated with the eWAY Rapid Payments module.</div>
  
===Not using eWAY? ===
+
==Troubleshooting==
 +
 
 +
''N/A''
  
Join thousands of merchants who choose eWAY as their preferred online payment provider. Create an eWAY account and get your online store transacting quickly with our FREE WHMCS extension today.
 
<div class="docs-alert-info">''' [https://my.eway.io/whmcs Create an eWAY Account]'''</div>
 
 
{{modules}}
 
{{modules}}

Revision as of 19:40, 24 March 2022

We added this module in WHMCS 7.9. It supersedes the EWAY Rapid 3.1 module.

eWAY lets WHMCS users to accept online credit card payments easily and securely so they can grow their business fast. The Secure Fields solution allows merchants to securely and seamlessly process payments from their own website, without exposing the sensitive card data.

Further, the WHMCS integration takes advantage of Token Payments, allowing customers to securely store the card information within eWAY’s PCI DSS environment, and WHMCS uses the Token (which represent the saved card) to handle all future payments without the customer having to key in their details again.

Supported Features

Type One Time Recurring Refunds 3D Secure
Token Yes Yes Yes No
Remote Update Card Remote Delete Card AddPayMethod API
Yes No No

Adding the EWAY Payment Gateway

To set up the EWAY payment gateway in WHMCS:

  1. Go to Configuration () > System Settings > Payment Gateways or, prior to WHMCS 8.0, Setup > Products/Services > Payment Gateways.
  2. Choose the All Payment Gateways tab.
  3. Click EWAY.
  4. Check Show on Order Form to display this payment method in the Client Area during checkout.
  5. Create and enter your EWAY credentials:
    1. Create an eWay account.
    2. Log in to the MYeWAY Dashboard.
    3. Go to My Account > API Key.
    4. Copy and paste your API key and password into WHMCS. For information on setting up your API key and password, see the eWAY Knowledge base..
    5. Copy and paste your public API key (Pay Now Button Public API key) into WHMCS. For information on obtaining your Public API Key, see Finding my Public API Key
  6. Click Save Changes.

Test Mode

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

Migrating to eWAY from eWAY Rapid 3.1

The eWAY Rapid 3.1 module included in previous versions of WHMCS can be easily replaced with the eWAY module. If the WHMCS installation has existing tokens stored from the previous module, a button will be shown on the Payment Gateways configuration page to swiftly migrate the tokens to the new module.

  1. Obtain the Public API Key from eWAY as detailed above.
  2. Log into your WHMCS admin area.
  3. Navigate to the Setup menu.
  4. Click on the Payments option, and then again on Payment gateways.
  5. Enter your administrator password if prompted.
  6. Click on the Manage Existing Gateways button and locate the eWAY Rapid Module.
  7. Click on the Migrate to eWAY Module button.
  8. Enter the Public API Key where prompted and press the Migrate button
  9. The page will save and reload showing the eWAY module is active and the eWAY Rapid Module disabled
  10. Update any configuration on the newly activated module as required.
The Migrate to eWAY Module will only show if the WHMCS installation has Payment Methods associated with the eWAY Rapid Payments module.

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