Title: Eway Payment Gateway
Author: webaware
Published: <strong>April 9, 2012</strong>
Last modified: December 14, 2025

---

Search plugins

![](https://ps.w.org/eway-payment-gateway/assets/banner-772x250.png?rev=2590622)

![](https://ps.w.org/eway-payment-gateway/assets/icon-256x256.png?rev=2590622)

# Eway Payment Gateway

 By [webaware](https://profiles.wordpress.org/webaware/)

[Download](https://downloads.wordpress.org/plugin/eway-payment-gateway.5.3.0.zip)

 * [Details](https://wordpress.org/plugins/eway-payment-gateway/#description)
 * [Reviews](https://wordpress.org/plugins/eway-payment-gateway/#reviews)
 * [Development](https://wordpress.org/plugins/eway-payment-gateway/#developers)

 [Support](https://wordpress.org/support/plugin/eway-payment-gateway/)

## Description

The Eway Payment Gateway adds integrations for the [Eway credit card payment gateway](https://eway.io/)
through [Rapid API Direct Payments](https://www.eway.com.au/features/api-rapid-api/).
These plugins are supported:

 * [WP eCommerce](https://wordpress.org/plugins/wp-e-commerce/) shopping cart plugin
 * [WooCommerce](https://wordpress.org/plugins/woocommerce/) shopping cart plugin
 * [WordPress Classifieds Plugin](https://wordpress.org/plugins/another-wordpress-classifieds-plugin/)
   classified ads plugin
 * [Event Espresso 4](https://wordpress.org/plugins/event-espresso-decaf/)
 * [Events Manager Pro](https://eventsmanagerpro.com/) event bookings plugin

Looking for a Gravity Forms integration? Try [Gravity Forms Eway](https://gfeway.webaware.net.au/).

### Features

 * card holder’s name can be different to the purchaser’s name
 * basic data validation performed before submitting to Eway
 * Eway transaction ID and bank authcode are recorded for successful payments
 * supports Authorize (PreAuth) for drop-ship merchants / delayed billing
 * supports Beagle anti-fraud measures (for supporting plugins)
 * it’s free!

### Requirements

 * you need to install one of the ecommerce plugins listed above
 * you need an SSL/TLS certificate for your hosting account
 * you need an account with Eway Australia
 * this plugin uses Eway’s [Rapid API Direct Payments](https://www.eway.com.au/features/api-rapid-api/),
   and does not support Eway’s Responsive Shared Page

### Translations

Many thanks to the generous efforts of our translators:

 * English (en_GB) — [the English (British) translation team](https://translate.wordpress.org/locale/en-gb/default/wp-plugins/eway-payment-gateway)

If you’d like to help out by translating this plugin, please [sign up for an account and dig in](https://translate.wordpress.org/projects/wp-plugins/eway-payment-gateway).

### Sponsorships

 * Another WordPress Classifieds Plugin integration generously sponsored by [Michael Major Media](https://michaelmajor.com.au/)
 * Events Manager Pro integration generously sponsored by [Michael Major Media](https://michaelmajor.com.au/)
 * Event Espresso 4 integration generously sponsored by [Rural Aid](https://www.ruralaid.org.au/)

Thanks for sponsoring new features for Eway Payment Gateway!

### Privacy

Information gathered for processing a credit card transaction is transmitted to 
Eway for processing, and in turn, Eway passes that information on to your bank. 
Please review [Eway’s Privacy Policy](https://www.eway.com.au/legal#privacy) for
information about how that affects your website’s privacy policy. By using this 
plugin, you are agreeing to the terms of use for Eway.

## Screenshots

 * [[
 * WP eCommerce payments settings
 * [[
 * WP eCommerce Sales Log with transaction ID and authcode
 * [[
 * WooCommerce payments settings
 * [[
 * WooCommerce order details with transaction ID and authcode
 * [[
 * Events Manager payments settings
 * [[
 * Events Manager transactions with transaction ID and authcode
 * [[
 * Another WordPress Classifieds Plugin payments settings
 * [[
 * Event Espresso 4 payments settings

## FAQ

### Configuring for WP eCommerce

 1. Navigate to ‘Settings > Store > Payments’ on the menu
 2. Activate the Eway payment gateway and click the Update button
 3. Edit the Eway payment gateway settings by hovering your mouse over the gateway’s
    name and clicking the hidden ‘edit’ link
 4. Enter your Rapid API key/password and Client Side Encryption keys for your live
    site and the sandbox
 5. Select the appropriate settings for your site, including which checkout fields 
    map to Eway fields

### Configuring for WooCommerce

 1. Navigate to ‘WooCommerce > Settings > Payment Gateways’ on the menu
 2. Select Eway from the Payment Gateways menu
 3. Tick the field ‘Enable/Disable’ to enable the gateway
 4. Enter your Rapid API key/password and Client Side Encryption keys for your live
    site and the sandbox
 5. Select the appropriate settings for your site

### Configuring for Another WordPress Classifieds Plugin

 1. Navigate to ‘Classified > Settings > Payment’ on the menu
 2. Click the Activate Eway checkbox
 3. Enter your Rapid API key/password and Client Side Encryption keys for your live
    site and the sandbox
 4. Select the appropriate settings for your site

### Configuring for Event Espresso

 1. Navigate to ‘Event Espresso > Payment Methods’ on the menu
 2. Select Eway from the Payment Methods menu
 3. Click the Activate Eway Payments button
 4. Enter your Rapid API key/password and Client Side Encryption keys for your live
    site and the sandbox
 5. Select the appropriate settings for your site

### Configuring for Events Manager

 1. Navigate to ‘Events > Payment Gateways’ on the menu
 2. Click the Activate link underneath the Eway gateway name
 3. Click the Settings link underneath the Eway gateway name
 4. Enter your Rapid API key/password and Client Side Encryption keys for your live
    site and the sandbox
 5. Select the appropriate settings for your site

### How do I test payments with Eway?

You should always test your payments first in the Eway sandbox. You will need to
sign up for a sandbox account, and copy your Rapid API key/password and Client Side
Encryption key from the sandbox MyEway. When you go to pay, only use dummy card 
numbers like 4444333322221111. This allows you to make as many test purchases as
you like, without billing a real credit card.

 * [What is the sandbox and how do I get it?](https://go.eway.io/s/article/What-is-the-Sandbox-and-how-do-I-get-it)
 * [Test Credit Card Numbers](https://go.eway.io/s/article/Test-Credit-Card-Numbers)

### What is Eway?

Eway is a leading provider of online payments solutions with a presence in Australia,
New Zealand, and Asia. This plugin integrates with Eway so that your website can
safely accept credit card payments.

### Is recurring billing supported?

Not yet. I know it can be done but I haven’t had a website that needs it yet, so
have not written the code for it.

If you just need a simple way to record recurring payments such as donations, you
might want to try [Gravity Forms](https://webaware.com.au/get-gravity-forms) and
[Gravity Forms Eway](https://gfeway.webaware.net.au/) which does support recurring
payments.

### Do I need an SSL/TLS certificate for my website?

Yes. This plugin uses the Direction Connection method to process transactions, so
you must have HTTPS encryption for your website.

### What’s the difference between the Capture and Authorize payment methods?

Capture charges the customer’s credit card immediately. This is the default payment
method, and is the method most websites will use for credit card payments.

Authorize checks to see that the transaction would be approved, but does not process
it. Eway calls this method [PreAuth](https://www.eway.com.au/features/payments/payments-pre-auth/).
Once the transaction has been authorized, you can complete it manually in your MyEway
console. You cannot complete PreAuth transactions from WordPress.

**NB: PreAuth is currently only available for Australian, Singapore, Malaysian, &
Hong Kong merchants. Do not select Authorize if you are a New Zealand merchant!**

### Do I need to set the Client-Side Encryption Key?

Client-Side Encryption is required for websites that are not PCI certified. It encrypts
sensitive credit card details in the browser, so that only Eway can see them. All
websites are encouraged to set the Client-Side Encryption Key for improved security
of credit card details.

If you get the following error, you _must_ add your Client-Side Encryption key:

> V6111: Unauthorized API Access, Account Not PCI Certified

You will find your Client-Side Encryption key in MyEway where you created your API
key and password. Copy it from MyEway and paste into the Eway Payments settings 
page.

### Why do I get an error “Invalid TransactionType”?

> V6010: Invalid TransactionType, account not certified for eCome only MOTO or Recurring
> available

It probably means you need to set your Client-Side Encryption key; see above. It
can also indicate that your website has JavaScript errors, which can prevent Client-
Side Encryption from working. Check for errors in your browser’s developer console.

If your website is PCI Certified and you don’t want to use Client-Side Encryption
for some reason, then you will still get this error in the sandbox until you enable
PCI for Direct Connections in MyEway:

Settings > Sandbox > Direction Connection > PCI

### What is Beagle Lite?

[Beagle Lite](https://www.eway.com.au/features/fraud-protection/fraud-lite/) is 
a service from Eway that provides fraud protection for your transactions. It uses
information about the purchaser to suggest whether there is a risk of fraud. Configure
Beagle Lite rules in your MyEway console.

**NB**: Beagle Lite fraud detection requires an address for each transaction. Be
sure to add an Address field to your forms, and make it a required field. The minimum
address part required is the Country, so you can just enable that subfield if you
don’t need a full address.

### Where do I find the Eway transaction number?

 * **WP eCommerce**: the Eway transaction number and the bank authcode are shown
   under Billing Details when you view the sales log for a purchase in the WordPress
   admin.
 * **WooCommerce**: the Eway transaction number and the bank authcode are shown 
   in the Custom Fields block when you view the order in the WordPress admin.
 * **Event Espresso**: the Eway transaction number and the bank authcode are shown
   in the Payment Details block when you view the transaction in the WordPress admin.
 * **Events Manager**: from the Payment Gateways menu item or the Bookings menu 
   item, you can view a list of transactions; the Eway transaction ID is shown in
   the Transaction ID column, and the authcode in the Notes column.
 * **Another WordPress Classifieds Plugin**: not available yet

### Can I use this plugin with the WP eCommerce Gold Cart?

Yes, if you deactivate the Gold Cart’s Eway payment gateway and activate this one.

### I get an SSL error when my checkout attempts to connect with Eway

This is a common problem in local testing environments. Please [read this post](https://snippets.webaware.com.au/howto/stop-turning-off-curlopt_ssl_verifypeer-and-fix-your-php-config/)
for more information.

### Can I use this plugin on any shared-hosting environment?

The plugin will run in shared hosting environments, but requires PHP 7.4 or later.

### WP eCommerce filter hooks

Developers can [refer to the code](https://github.com/webaware/eway-payment-gateway/blob/master/includes/integrations/class.WPeCommerce.php)
for filter hook parameters.

 * `wpsc_merchant_eway_invoice_desc` for modifying the invoice description
 * `wpsc_merchant_eway_invoice_ref` for modifying the invoice reference
 * `wpsc_eway_credentials` for modifying the Eway credentials used in the transaction

### WooCommerce filter hooks

Developers can [refer to the code](https://github.com/webaware/eway-payment-gateway/blob/master/includes/integrations/class.WooCommerce.php)
for filter hook parameters.

 * `woocommerce_eway_invoice_desc` for modifying the invoice description
 * `woocommerce_eway_invoice_ref` for modifying the invoice reference
 * `woocommerce_eway_icon` for changing the payment gateway icon
 * `woocommerce_eway_credentials` for modifying the Eway credentials used in the
   transaction
 * `woocommerce_eway_method_capture` to allow per-order capture or authorize
 * `woocommerce_eway_error_msg` to allow developers to provide richer error messages

### Another WordPress Classifieds Plugin filter hooks

Developers can [refer to the code](https://github.com/webaware/eway-payment-gateway/blob/master/includes/integrations/class.AWPCP.php)
for filter hook parameters.

 * `awpcp_eway_invoice_desc` for modifying the invoice description
 * `awpcp_eway_invoice_ref` for modifying the invoice reference
 * `awpcp_eway_icon` for changing the payment gateway icon
 * `awpcp_eway_checkout_message` for changing the message above the checkout form
 * `awpcp_eway_credentials` for modifying the Eway credentials used in the transaction

### Events Manager filter hooks

Developers can [refer to the code](https://github.com/webaware/eway-payment-gateway/blob/master/includes/integrations/class.EventsManager.php)
for filter hook parameters.

 * `em_eway_invoice_desc` for modifying the invoice description
 * `em_eway_invoice_ref` for modifying the invoice reference
 * `em_eway_amount` for changing the billed amount (e.g. adding fees)
 * `em_eway_credentials` for modifying the Eway credentials used in the transaction

### Event Espresso 4 filter hooks

Developers can [refer to the code](https://github.com/webaware/eway-payment-gateway/blob/master/includes/integrations/event_espresso_eway/class.Gateway.php)
for filter hook parameters.

 * `event_espresso_eway_invoice_desc` for modifying the invoice description
 * `event_espresso_eway_invoice_ref` for modifying the invoice reference

## Reviews

![](https://secure.gravatar.com/avatar/0c0e5c29f6f3224fed4fa279beae607e7b90fc101371b26f6f50fba92a2059c1?
s=60&d=retro&r=g)

### 󠀁[It’s better than the official plugin](https://wordpress.org/support/topic/its-better-than-the-official-plugin/)󠁿

 [luisfarias](https://profiles.wordpress.org/luisfarias/) November 25, 2021

The official plugin never worked for me. Check out the repository for this and much
better, more documented, more options. Definitely better.

![](https://secure.gravatar.com/avatar/04dce7c9a6d0f8e96c70c32ac5a95157ad137d4cc13aac8c467f6e6f1743fdb3?
s=60&d=retro&r=g)

### 󠀁[Works but not exactly as described – PREAUTH](https://wordpress.org/support/topic/works-but-not-exactly-as-described-preauth/)󠁿

 [angelus512](https://profiles.wordpress.org/angelus512/) June 7, 2020

Hello, Your plugin works mostly as described however I do not think your statement
of it “supporting Pre-Auth” transactions is accurate. It supports Pre-Auth transactions
but you are unable to then “capture” those transactions from within WooCommerce.
You have to login to eWay separately and then manually compare the transactions 
from WooCommerce to the eWay Pre-Auths (in the eway dashboard) and then manually
capture them in eWay one by one by one. When dealing with 10 or so per day is no
issue but when dealing with 20-30+ per day that starts to become a major oversight
and issue. Shopify’s eWay integration supports the Authorization and later Capture
of pre-auth transactions. I don’t understand why your WooCommerce plugin cannot 
do the same from within WooCommerce? For that reason its a 3 star at this point 
in my book.

![](https://secure.gravatar.com/avatar/649a4f3969875ab93109748356d8930c3486b51d436a61c2188f02191934cc95?
s=60&d=retro&r=g)

### 󠀁[Superb integration with Event Espresso 4](https://wordpress.org/support/topic/superb-integration-with-event-espresso-4/)󠁿

 [Josh Feck](https://profiles.wordpress.org/builtbynorthby/) November 28, 2018

This plugin just works. Recommended ++

![](https://secure.gravatar.com/avatar/728c344e71856cc88ba364b4f65005c0f395b9f08e53326d674b8dd76c552110?
s=60&d=retro&r=g)

### 󠀁[Place Holder Change](https://wordpress.org/support/topic/place-holder-change-2/)󠁿

 [Dhruvit](https://profiles.wordpress.org/12054d/) November 16, 2018

Good support

![](https://secure.gravatar.com/avatar/45b04009205ea8ef306d989b198002d29ce65dfb0825a0fb6924a0a71ac3f026?
s=60&d=retro&r=g)

### 󠀁[Good Job](https://wordpress.org/support/topic/good-job-900/)󠁿

 [rameshwor.maharjan](https://profiles.wordpress.org/rameshwormaharjan/) July 19,
2018

dumped the official woocommerce for one reason – this plugin allows you to add credit
card form on checkout page instead of new page

![](https://secure.gravatar.com/avatar/1fe3f3421062d8cc9e678fcf9e2727dc4afa3bce1d6bfd99d01da8a0065359b5?
s=60&d=retro&r=g)

### 󠀁[Avoid them like they have Ebola](https://wordpress.org/support/topic/avoid-them-like-they-have-ebola/)󠁿

 [johnc1979](https://profiles.wordpress.org/johnc1979/) November 8, 2017 1 reply

Absolutely terrible company to deal with. Support is hopeless and slow. There are
far better options out there. Just bad 0/5

 [ Read all 15 reviews ](https://wordpress.org/support/plugin/eway-payment-gateway/reviews/)

## Contributors & Developers

“Eway Payment Gateway” is open source software. The following people have contributed
to this plugin.

Contributors

 *   [ webaware ](https://profiles.wordpress.org/webaware/)

“Eway Payment Gateway” has been translated into 5 locales. Thank you to [the translators](https://translate.wordpress.org/projects/wp-plugins/eway-payment-gateway/contributors)
for their contributions.

[Translate “Eway Payment Gateway” into your language.](https://translate.wordpress.org/projects/wp-plugins/eway-payment-gateway)

### Interested in development?

[Browse the code](https://plugins.trac.wordpress.org/browser/eway-payment-gateway/),
check out the [SVN repository](https://plugins.svn.wordpress.org/eway-payment-gateway/),
or subscribe to the [development log](https://plugins.trac.wordpress.org/log/eway-payment-gateway/)
by [RSS](https://plugins.trac.wordpress.org/log/eway-payment-gateway/?limit=100&mode=stop_on_copy&format=rss).

## Changelog

[The full changelog can be found on GitHub](https://github.com/webaware/eway-payment-gateway/blob/master/changelog.md).
Recent entries:

### 5.3.0

Released 2024-06-07

 * changed: set the WooCommerce order transaction ID property; still also setting
   custom Transaction ID meta data, for now
 * changed: marked as tested up to WooCommerce 8.9

## Meta

 *  Version **5.3.0**
 *  Last updated **4 months ago**
 *  Active installations **800+**
 *  WordPress version ** 5.1 or higher **
 *  Tested up to **6.9.4**
 *  PHP version ** 7.4 or higher **
 *  Languages
 * [English (Australia)](https://en-au.wordpress.org/plugins/eway-payment-gateway/),
   [English (Canada)](https://en-ca.wordpress.org/plugins/eway-payment-gateway/),
   [English (New Zealand)](https://en-nz.wordpress.org/plugins/eway-payment-gateway/),
   [English (South Africa)](https://en-za.wordpress.org/plugins/eway-payment-gateway/),
   [English (UK)](https://en-gb.wordpress.org/plugins/eway-payment-gateway/), and
   [English (US)](https://wordpress.org/plugins/eway-payment-gateway/).
 *  [Translate into your language](https://translate.wordpress.org/projects/wp-plugins/eway-payment-gateway)
 * Tags
 * [awpcp](https://wordpress.org/plugins/tags/awpcp/)[Event Espresso](https://wordpress.org/plugins/tags/event-espresso/)
   [Events Manager](https://wordpress.org/plugins/tags/events-manager/)[eway](https://wordpress.org/plugins/tags/eway/)
   [woocommerce](https://wordpress.org/plugins/tags/woocommerce/)
 *  [Advanced View](https://wordpress.org/plugins/eway-payment-gateway/advanced/)

## Ratings

 4.3 out of 5 stars.

 *  [  12 5-star reviews     ](https://wordpress.org/support/plugin/eway-payment-gateway/reviews/?filter=5)
 *  [  0 4-star reviews     ](https://wordpress.org/support/plugin/eway-payment-gateway/reviews/?filter=4)
 *  [  1 3-star review     ](https://wordpress.org/support/plugin/eway-payment-gateway/reviews/?filter=3)
 *  [  0 2-star reviews     ](https://wordpress.org/support/plugin/eway-payment-gateway/reviews/?filter=2)
 *  [  2 1-star reviews     ](https://wordpress.org/support/plugin/eway-payment-gateway/reviews/?filter=1)

[Your review](https://wordpress.org/support/plugin/eway-payment-gateway/reviews/#new-post)

[See all reviews](https://wordpress.org/support/plugin/eway-payment-gateway/reviews/)

## Contributors

 *   [ webaware ](https://profiles.wordpress.org/webaware/)

## Support

Got something to say? Need help?

 [View support forum](https://wordpress.org/support/plugin/eway-payment-gateway/)

## Donate

Would you like to support the advancement of this plugin?

 [ Donate to this plugin ](https://shop.webaware.com.au/donations/?donation_for=Eway+Payment+Gateway)