- build online donation forms
- build online booking forms
- build simple Buy Now forms
- accept recurring payments (Australian merchants only; see FAQ)
NB: this plugin extends Gravity Forms; you still need to install and activate Gravity Forms!
Go Pro and access these additional features:
- record entry even when transaction fails
- use Responsive Shared Page, no need for SSL certificate on standard payments
- create complex forms with feeds mapping fields to eWAY
- create token payment customers
- remember customer cards using tokens
- send shipping addresses to eWAY
- use sophisticated conditional logic
- mix multiple currencies on one website
- mix multiple eWAY accounts on one website
- recurring payments generously sponsored by Castle Design
Thanks for sponsoring new features on Gravity Forms eWAY!
If you’d like to help out by translating this plugin, please sign up for an account and dig in.
- you need to install the Gravity Forms plugin
- you need an SSL/TLS certificate for your hosting account
- you need an account with eWAY
- this plugin uses eWAY’s Rapid API Direct Payments and Recurring Payments XML API, and does not support eWAY’s Responsive Shared Page (available with Pro)
Developers can use these filter hooks to modify some eWAY invoice properties. Each filter receives a string for the field value, and the Gravity Forms form array.
gfeway_form_is_ewayfor telling Gravity Forms eWAY to ignore a form
gfeway_code_descriptionfor modifying the eWAY Rapid API error messages
gfeway_invoice_descfor modifying the invoice description
gfeway_invoice_reffor modifying the invoice reference
gfeway_invoice_trans_numberfor modifying the invoice transaction reference
gfeway_invoice_option1for setting the option1 field (one-off payments)
gfeway_invoice_option2for setting the option2 field (one-off payments)
gfeway_invoice_option3for setting the option3 field (one-off payments)
gfeway_invoice_cust_commentsfor setting the customer comments field (recurring payments)
gfeway_recurring_periodsfor filtering the available recurring periods (from ‘weekly’, ‘fortnightly’, ‘monthly’, ‘quarterly’, ‘yearly’)
- Either install automatically through the WordPress admin, or download the .zip file, unzip to a folder, and upload the folder to your /wp-content/plugins/ directory. Read Installing Plugins in the WordPress Codex for details.
- Activate the plugin through the ‘Plugins’ menu in WordPress.
- Install and activate the Gravity Forms plugin.
- Edit the eWAY Payments settings to set your eWAY API key, API password, Customer ID, Client-Side Encryption Key, and options.
Gravity Forms will now display the Credit Card and Recurring fields under Pricing Fields when you edit a form.
Building a Form with Credit Card Payments
- add one or more Product fields or a Total field, or a Recurring field, so that there is something to be charged by credit card
- add a Name field (with first name and last name) if you want to see the customer’s name on the eWAY transaction; the first name field will be sent to eWAY
- add an Email field and an Address field if you want to see them on your eWAY transaction; the first Email field and first Address field on the form will be sent to eWAY
- add a Credit Card field; if you have a multi-page form, this must be on the last page so that all other form validations occur first
- add a confirmation message to the form indicating that payment was successful; the form will not complete if payment was not successful, and will display an error message in the Credit Card field
NB: you should always test your gateway first by using eWAY’s test server. To do this, select Use Sandbox in the eWAY Payments settings. When you go to pay, use the special test card number 4444333322221111. This allows you to make as many test payments as you like, without billing a real credit card.
- 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.
- Will this plugin work without installing Gravity Forms?
No. This plugin integrates eWAY with Gravity Forms so that you can add online payments to your forms. You must purchase and install a copy of the Gravity Forms plugin too.
- Can I use eWAY outside of Australia?
Yes, for standard card payments. See the eWAY website for details.
Recurring Payments is only available for Australian merchants. PreAuth is only available for Australian, Singapore, Malaysian, & Hong Kong merchants.
- 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.
Go Pro to use eWAY’s Responsive Shared Page without requiring an SSL/TLS certificate on your website with standard payments. Recurring payments requires an SSL/TLS certificate with the Free and the Pro add-ons.
- 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 (or Stored Payments in the old XML API). Once the transaction has been authorized, you can complete it manually in your MYeWAY console. You cannot complete PreAuth transactions from WordPress/Gravity Forms.
You need to add your eWAY API key and password to see PreAuth transactions in the sandbox, so that the Rapid API is used. The old Stored Payments XML API does not have a sandbox.
NB: PreAuth is currently only available for Australian, Singapore, Malaysian, & Hong Kong merchants.
- 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
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. See screenshots
Settings > Sandbox > Direction Connection > PCI
- Where has the credit card type gone?
Gravity Forms normally logs the card type with a partial card number when you have a credit card form. With Client-Side Encryption, Gravity Forms no longer sees the credit card number so it cannot detect the card type. When that happens, the card type is listed simply as “Card”.
You can still see the card type and partial card number in MYeWAY transaction details.
- What is Beagle Lite?
Beagle 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.
- What Gravity Forms license do I need?
Any Gravity Forms license will do. You can use this plugin with a Personal, Business or Developer license.
- Where do I find the eWAY transaction number?
Successful transaction details including the eWAY transaction number and bank authcode are shown in the Info box when you view the details of a form entry in the WordPress admin.
Recurring payments don’t get a transaction number when the payment is established, so only the payment status and date are recorded.
- How do I add a confirmed payment amount and transaction number to my Gravity Forms notification emails?
Browse to your Gravity Form, select Notifications and use the Insert Merge Tag dropdown (Payment Amount, Transaction Number and AuthCode will appear under Custom at the very bottom of the dropdown list).
- Why is the amount paid bigger than the form total when sandbox is enabled?
When the sandbox is enabled, the payment amount is rounded up by default, because the eWAY sandbox server can return different error codes when the amount has cents. This can be a useful feature for testing how your website displays errors, but you normally don’t want it when testing a payment form.
- Why do I get an error “This page is unsecured”?
When your form has a Credit Card field, it accepts very sensitive details from your customers and these must be encrypted. You must have an SSL/TLS certificate installed on your website, and your page must be accessed via HTTPS (i.e. the page address must start with “https:”). You can force a page with a credit card form to be accessed via HTTPS by ticking Force SSL on the Credit Card field advanced settings page; see screenshots.
- Can I do recurring payments?
Recurring Payments is only available for Australian merchants. This feature is available thanks to the generous sponsorship of Castle Design.
If you use conditional logic to hide/show a Product field and a Recurring Payment field, you can even let customers choose between a one-off payment and a recurring payment. Payments can be scheduled for weekly, fortnightly, monthly, quarterly, or yearly billing.
NB: some banks do not accept recurring payments via the eWAY Recurring Payments API. I’ve heard that Bendigo Bank is one that does not. Please check with eWAY and your bank for more information.
- I get an SSL error when my form attempts to connect with eWAY
This is a common problem in local testing environments. Read how to fix your website SSL configuration.
- Can I use this plugin on any shared-hosting environment?
The plugin will run in shared hosting environments, but requires PHP 5 with the following modules enabled (talk to your host). All are typically available because they are enabled by default in PHP 5, but may be disabled on some shared hosts.
This plugin works great!
What’s even better is that the developer Ross offers quick support and has gone out of his way to help us.
Worked as expected, thank you!
Contributors & Developers
“Gravity Forms eWAY” is open source software. The following people have contributed to this plugin.Contributors
Interested in development?
The full changelog for Gravity Forms eWAY can be found on GitHub. Recent entries:
- fixed: logging should not record encrypted card details (even though they’re encrypted)
- fixed: stored payments legacy API fails
- changed: replace old $field array access with GF_Field object access
- changed: log which API was used, and capture or authorise