PxPay 2.0 upgrade for WP eCommerce and Gravity Forms
If you're based in New Zealand and take credit card payments via Payment Express, you may recently have received an email with a deadline to upgrade your WordPress website to work with the PxPay 2.0 interface.
Here's a quick guide to check whether your e-commerce site is in good shape to continue accepting real-time payments beyond Tuesday, 5th September, 2016.
Run a test transaction
The quickest way to identify whether you need to upgrade is to run a transaction right through to the Payment Express hosted page. If you get there and the URL looks like this—
https://sec.paymentexpress.com/pxmi3/—there's no need to do anything. You can stop reading… now.
Payment via Gravity Forms
If you're running credit card transactions using Gravity Forms, you're almost certainly using Gravity Forms DPS PxPay to handle dealing with the payment gateway itself. If so, all you need to do is check the version number of the Gravity Forms DPS PxPay plugin.
- If you're running version 1.4.0 or higher, you're already covered and don't need to do anything.
- If you're on a version less than 1.4.0, you'll need to update. From your WordPress admin dashboard: Click Plugins, find Gravity Forms DPS PxPay, and click "Update now".
Running an older version of the plugin? You may have a version installed that's above the minimum for supporting PxPay 2.0, but while you're in the plugin admin you may as well take the opportunity to update to the latest version.
Payment via WP Ecommerce
The plugin, Gold Cart for WP e-Commerce, has provided support for Px*-flavoured payment gateways in the past, this being perhaps the only reason to purchase a licence for it. Unless you're using this plugin's Grid View option for your site's product layout—or for additional payment gateways—I recommend dropping this plugin completely.
To continue taking real-time payments with PxPay 2.0, installing the free DPS PxPay for WP eCommerce plugin will provide a new option in the Payments tab of the WP eCommerce admin.
After installing the plugin, visit the Payments tab in the WP eCommerce admin:
Settings > Store > Payments tab
You'll see a new option, "DPS Payment Express PxPay".
Setting up DPS Payment Express PxPay
Configuring the new gateway to continue real-time payment is straight-forward:
- Enter a value for the Display Name field, typically "Credit Card".
- Enter your Payment Express User ID.
- Enter your User Key.
- Set "Use Sandbox (testing)" to No.
Note: if you were previously using PxAccess for payments, combine the Access Key and Mac Key into one for the User Key. For example:
- Access Key
- Mac Key
- User Key
And, in case it's not clear, the User ID is the same as the Access User Id.
For the Merchant Reference and TxnData fields, you can choose which personal information from the order is carried across with the payment. One important caveat: though you'll see Email Address as an option, this appears to still not be widely supported—if at all—so if you need to pass an email as an identifier, use one of the TxnData fields to be sure.
Lastly, I noticed field values in the "DPS Payment Express PxPay" option were not sticking when saved. To ensure your values are saved, try deselecting any other DPS / Px* gateways in the Payment section, then click the Save Changes button. After this, you should see your values saved correctly. Note that your checkout option for this gateway will temporarily be unavailable while you make the switch.