🎉 Celebrate with 10% OFF on All Products! Use Code: GFEX10 Or Buy Any 2+ Items for 30% OFF with Code: GFEX30!

Gravity Forms eWAY Premium Add-on Setup Guide

Updated 5 min read Gravity Forms Payments & Pricing
On this page
  1. Step 1: Install and Activate Your License
  2. Step 2: Connect Your eWAY Account
  3. Payment page options
  4. Step 3: Create an eWAY Feed
  5. Step 4: What Customers See
  6. Step 5: Subscriptions
  7. Step 6: Manage Payments on the Entry
  8. Notification events
  9. Troubleshooting & FAQ
  10. The settings say eWAY did not accept the API key and password.
  11. An entry stays on “Processing”.
  12. The form says card payments are only available in some currencies.
  13. Renewals are not charged on time.
  14. Can I test without real money?
  15. What happens when I uninstall the add-on?

The Gravity Forms eWAY Premium Add-on lets your forms take card payments through eWAY, the payment gateway used by many businesses in Australia and New Zealand. Customers enter their card on the secure eWAY payment page (the Responsive Shared Page), so card details never touch your website. The add-on supports one-off payments, pre-authorisation with capture later, subscriptions with saved-card renewals and refunds from the entry screen.

This guide covers installation, connecting your eWAY account, payment feeds, pre-authorisation, subscriptions, the entry tools and troubleshooting.

System Requirements & Prerequisites

  • WordPress: Version 6.5 or higher
  • PHP: Version 7.4 or higher
  • Gravity Forms: Version 2.9 or higher, any licence
  • eWAY: an eWAY account with the Rapid API (start with a free eWAY sandbox account for testing) and its API key and API password
  • Currency: the Gravity Forms currency set to AUD, NZD, SGD, HKD or MYR, enabled on your eWAY account
  • WP-Cron: needed for subscription renewals (a real server cron that calls WP-Cron is recommended on low-traffic sites)
  • GravityExtra license: The add-on installed, activated and licensed with an active GravityExtra license key

Step 1: Install and Activate Your License

  1. In WordPress go to Plugins → Add New → Upload Plugin, upload the add-on ZIP file and click Activate.
  2. Go to Forms → Settings → eWAY, enter your key in the Gravity Extra License section and click Activate License.
  3. The page then shows the eWAY Account, Payment Page and Subscription Renewals sections.

Step 2: Connect Your eWAY Account

In MYeWAY open Settings → API Key and copy the API key and API password. Do this in your sandbox account first; a sandbox key never moves real money.

  • Mode — Sandbox (test) while you test, Live when you are ready to take real payments.
  • Sandbox API key / password and Live API key / password — paste the values for each mode. They are stored encrypted and are never shown again; leave the fields empty later to keep the saved values.

Click Save Settings. The section then shows the connection status: “Connected: eWAY accepted the API key and password”, or the reason eWAY gave when they do not work.

eWAY settings in Gravity Forms: sandbox or live mode, saved encrypted API keys and passwords, the connection status, payment page options and subscription renewals
Mode, encrypted API keys, the connection status, payment page options and renewals.

Payment page options

  • Page heading and Logo URL (an https:// image) shown on the eWAY page.
  • Page theme — one of the eWAY page themes.
  • Customer details — lock the name and address from the form so they cannot be changed on the eWAY page.

Step 3: Create an eWAY Feed

Open your form and go to Settings → eWAY → Add New. Choose the Transaction Type:

  • Products and Services with a payment action: Charge the card now, or Authorise only (pre-auth) to hold the amount and capture it later from the entry.
  • Subscription — a recurring payment charged to the saved card (see Step 5).

Map the Billing Information fields (name, company, phone, email, address) so the eWAY page is pre-filled. The Payment description supports merge tags, for example Course booking {Name (First):1.3}, and is shown on the eWAY page and receipt (up to 64 characters). With Send form notifications only after the payment is approved switched on, unpaid or declined orders do not send any notification.

eWAY feed settings: charge the card now or authorise only, payment amount, description and the option to send notifications after the payment is approved
Payment action, amount, description and the notification option of an eWAY feed.

Step 4: What Customers See

After the customer clicks the submit button, they are sent to the secure eWAY payment page with their details pre-filled, enter their card there and come back to your confirmation message. If the card is declined, they see a friendly message (no bank codes) and a Try again with another card link that opens a new eWAY page for the same entry. If they cancel, nothing is charged and they can return to the payment page.

The add-on never trusts the address bar: when the customer comes back it reads the result from eWAY with your API key and checks the transaction (status, amount and currency) before the entry is marked as paid. If a customer pays and closes the browser before returning, the hourly check confirms the payment anyway. Checkouts that are never finished are closed after 48 hours.

Step 5: Subscriptions

Choose Subscription, then set the Recurring Amount, the Billing Cycle (daily, weekly, monthly or yearly) and the number of payments (or infinite). Extra options:

  • Setup Fee — charged once together with the first payment (or on its own when there is a free trial).
  • Free trial (days) — the card is saved now and the first subscription payment is charged after this many days.

The card is saved at eWAY as a token; your site only keeps the token reference. The add-on charges each renewal on schedule (checked every hour). Before every renewal it looks up the renewal’s own reference at eWAY, so a renewal is never charged twice, even after a timeout. Monthly renewals keep their day of the month (31 January → 28 February → 31 March).

In Subscription Renewals choose how often a declined renewal is tried again (every 2 days, default 3 retries). After the last try the subscription is cancelled. The Gravity Forms Cancel Subscription button on the entry stops all further charges.

Step 6: Manage Payments on the Entry

Each entry shows an eWAY box with the reference, the amount, the eWAY transaction, the authorisation code and the eWAY response.

  • Refund — refund all or part of a charged payment. The transaction is checked at eWAY first.
  • Capture and Cancel authorisation — for pre-authorised payments: charge all or part of the held amount, or release it.
  • Check payment at eWAY — for a checkout that is still open, read the result at once.
eWAY box on a Gravity Forms entry: partially refunded card payment with reference, amount, transaction, authorisation code and the Refund button
The eWAY box on an entry: amount, transaction, refund.

Notification events

Payment notifications can be sent on: Payment Completed, Payment Failed, Payment Refunded, Payment Authorized, Authorization Voided, Subscription Created, Subscription Canceled, Subscription Expired, Subscription Payment Added and Subscription Payment Failed.

Troubleshooting & FAQ

The settings say eWAY did not accept the API key and password.

The key and password belong to the other mode (sandbox keys only work in sandbox mode) or the password was changed in MYeWAY. Copy both again from Settings → API Key in the account of the selected mode.

An entry stays on “Processing”.

The customer has not finished the eWAY page yet. Click Check payment at eWAY on the entry, or wait for the hourly check. Checkouts that are never finished are closed after 48 hours.

The form says card payments are only available in some currencies.

Set the Gravity Forms currency (Forms → Settings) to AUD, NZD, SGD, HKD or MYR, and make sure eWAY has enabled that currency for your account.

Renewals are not charged on time.

Renewals run with WP-Cron, which only runs when someone visits the site. On quiet sites set up a server cron that calls wp-cron.php every 15–60 minutes.

Can I test without real money?

Yes. Keep the mode on Sandbox and use your sandbox API key and password with the eWAY test cards. Sandbox entries show a “Sandbox mode — test payment” badge.

What happens when I uninstall the add-on?

Forms → Settings → Uninstall removes the settings, the stored keys and the renewal schedule. Entries keep their payment details; saved card tokens stay in your eWAY account.

Still need help?

Our support team answers tickets every day, usually within a few hours.

0
0
Your Cart
Your cart is emptyReturn to Shop
🔥 FREQUENTLY BOUGHT TOGETHER
Complete Combo & Save 40%!
ITEM IN YOUR CART
Gravity Forms Klaviyo Add-on
$39.00/yr
+
🎁 RECOMMENDED ADD-ON SAVE 40% OFF
Original Price: $39.00/yr
Bundle Special Price: $23.40/yr