Gravity Forms Eway
PluginEasily create online payment forms with Gravity Forms and Eway.
- 0 stars
- 0 watching
- 0 downloads
- GPL-2.0-or-later
-
2.7.0 Latest
fixed: recurring payments broken in Gravity Forms 3.0+ Release notes
Show 54 versions not available yet
Releases named in the vendor’s changelog or on WordPress.org that the repository does not have yet.
-
2.6.1 Not available yet
fixed: missing a template that lists any missing required PHP modules
-
2.6.0 Not available yet
fixed: PHP notice on deprecated creation of dynamic properties in PHP 8.1+
-
2.5.1 Not available yet
fixed: fatal error when used with Coupons add-on
-
2.5.0 Not available yet
fixed: handle invalid start/end dates getting recurring payment description
-
2.4.1 Not available yet
fixed: hide subfields of Recurring field for new forms without Gravity Forms legacy markup
-
2.4.0 Not available yet
changed: update with new Eway branding
-
2.3.1 Not available yet
fixed: icon colour in Gravity Forms 2.5 settings
-
2.3.0 Not available yet
changed: requires PHP version 7.0+
-
2.2.8 Not available yet
added: validates credit card number before running Client Side Encryption
-
2.2.7 Not available yet
changed: load front end CSE script from file, don't inline in the page footer
-
2.2.6 Not available yet
fixed: Gravity Forms 2.3 compatibility; don't directly access database tables
-
2.2.5 Not available yet
fixed: Recurring Payments could not send formatted phone numbers with () characters
-
2.2.4 Not available yet
fixed: logging should not record encrypted card details (even though they're encrypted)
-
2.2.3 Not available yet
fixed: don't attempt card processing if form validation fails (validation in other plugins; honeypot failure; save and continue heartbeat)
-
2.2.2 Not available yet
fixed: no confirmation message after saving settings
-
2.2.1 Not available yet
fixed: T2T Toolkit breaks posted Gravity Forms total field when products have options
-
2.2.0 Not available yet
changed: minimum required version of Gravity Forms is 1.9.15
-
2.1.5 Not available yet
fixed: PHP warning on static member access
-
2.1.4 Not available yet
fixed: don't use Client-Side Encryption on Recurring Payments (even when not used conditionally!)
-
2.1.3 Not available yet
fixed: Client-Side Encryption is now used for one-off transactions on forms that conditionally use Recurring Payments
-
2.1.2 Not available yet
fixed: "Are you sure you want to do this?" security message when trying to save a form confirmation
-
2.1.1 Not available yet
added: partner ID sent to Eway with payment requests (improved traceability)
-
2.1.0 Not available yet
added: support for Eway Client Side Encryption, allowing sites without PCI compliance to use Rapid 3.1 API
-
2.0.0 Not available yet
changed: uses Eway Rapid API if API key and password are set (not applicable for Recurring Payments)
-
1.8.0 Not available yet
fixed: prevent conditional recurring payment fields from losing their default values
-
1.7.0 Not available yet
fixed: Gravity Forms 1.9 compatibility
-
1.6.3 Not available yet
added: filter gfewayformiseway for telling Gravity Forms Eway to ignore a form
-
1.6.2 Not available yet
added: basic support for Gravity Forms Logging Add-On, to assist support requests; credit card numbers are obfuscated
-
1.6.1 Not available yet
fixed: Gravity Forms 1.8.9 Payment Details box on entry details
-
1.6.0 Not available yet
fixed: hidden products are now correctly handled
-
1.5.12 Not available yet
fixed: products with separate quantity fields fail
-
1.5.11 Not available yet
fixed: load datepicker styling for Gravity Forms 1.8.6 when no other datepicker fields are present
-
1.5.10 Not available yet
fixed: recurring payments failed on Windows hosting, no function strptime()
-
1.5.9 Not available yet
fixed: a datepicker was being added to the bottom of the page since WordPress 3.8 (jQuery-UI bug on set datepicker options late)
-
1.5.8 Not available yet
fixed: settings wouldn't save in WordPress multisite installations
-
1.5.7 Not available yet
fixed: a datepicker was being added to the bottom of the page when initial and start/end dates were hidden on recurring payments
-
1.5.6 Not available yet
fixed: Gravity Forms 1.7.7 changed their datepicker script handle and broke recurring fields (not all change is good!)
-
1.5.5 Not available yet
fixed: can select currency for Gravity Forms for forms not using credit card field, but still enforces AUD for forms with credit card field
-
1.5.4 Not available yet
fixed: recurring payments fields marked "required" were generating error "This field is required"
-
1.5.3 Not available yet
fixed: don't squabble with other plugins (e.g. DPS PxPay) for custom merge tags of same name
-
1.5.2 Not available yet
added: filter gfewayinvoicetransnumber for setting the invoice transaction reference (NB: 16 character limit)
-
1.5.1 Not available yet
fixed: merge tags work on new notification emails, not just on resends!
-
1.5.0 Not available yet
added: support for Beagle lite anti-fraud using geo-IP (Direct Payments only)
-
1.4.1 Not available yet
added: when entry is stored as 'Pending' for Stored Payment, can edit and change to 'Approved'
-
1.4.0 Not available yet
added: can now use Eway Stored Payments, e.g. for merchants who do drop-shipping
-
1.3.0 Not available yet
fixed: can't submit form multiple times and get multiple payments
-
1.2.2 Not available yet
fixed: error when recurring field is present on form, but hidden (thanks, Simon Watson!)
-
1.2.1 Not available yet
fixed: address on one-off Eway invoice was getting "0, " prepended when PHP < 5.3
-
1.2.0 Not available yet
added: option to disable whether remote SSL certificate must be verified (only disable if your website can't be correctly configured!)
-
1.1.0 Not available yet
added: options for extending use of Eway sandbox (testing) environment capabilities
-
1.0.3 Not available yet
fixed: don't show settings link if Gravity Forms is not installed and activated
-
1.0.2 Not available yet
fixed: correctly handle quantity for singleproduct fields
-
1.0.1 Not available yet
fixed: optional fields for address, email are no longer required for Eway payment
-
1.0.0 Not available yet
final cleanup and refactor for public release
Readme
GPL-2.0-or-laterGravity Forms Eway
Easily create online payment forms with Gravity Forms and Eway.
Gravity Forms Eway integrates the Eway credit card payment gateway with Gravity Forms advanced form builder, using Eway's Rapid API Direct Payments and Recurring Payments XML API.
- 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
Translations
If you'd like to help out by translating this plugin, please sign up for an account and dig in.
Requirements
- 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)
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 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.
Installation
- 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 documentation 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.
Faq
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 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 "Invalid TransactionType" error?
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. 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 a "This page is unsecured" error?
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.
Are there any filter hooks?
Developers can use these filter hooks to modify some Eway invoice properties.
Screenshots
- Options screen
- A sample donation form
- The sample donation form as it appears on a page
- How a credit card validation error appears
- A successful entry in Gravity Forms admin
- Example with recurring payments
- Forcing SSL on a page with a credit card form
- Enabling PCI for Direct Connections in the Sandbox
Upgrade Notice
2.7.0
fixed recurring payments broken in Gravity Forms 3.0+; fixed fatal error enqueuing scripts when form parameter is not a form
Install
composer require meteorgpl-plugin/gravityforms-ewayThe vendor’s license checks are intact: activate the plugin in WordPress with a license key bought from the vendor.
License
Declared license: GPL-2.0-or-later. The code is redistributed under the license the vendor declared in the plugin’s own headers. License profile: gpl-full.
Artwork, fonts, media and documents that may be licensed separately are not redistributed; the licensing page explains what is replaced or removed, and the security tab lists it per version. Support and update entitlement come with the license you buy from the vendor.