WooCommerce plugin configuration
Pre-requisites
Prior to installation of the Verifone Hosted cart the following prerequisites must be met:
- A WordPress installation with a version of at least 5.5.1
- The WooCommerce plugin must also be installed - https://woocommerce.com/
- In the WooCommerce settings "WooCommerce -> Settings -> General" Set the Default Customer Location to something other than the "No location by default" setting.
| Release date | Build | Release notes |
|---|---|---|
| 2021-08-31 | verifone-woocommerce-v2.0.1.zip |
|
Installation
This guide was written using the default WordPress theme. Other themes may have moved certain menu elements from their original location.
Installation of the Verifone Hosted cart plugin can and should be done just like any other plugin. Overall, there are two possible ways of installing the plugin. Either via the UI or by copying the plugin files to to appropriate location inside the WordPress installation.
Via the UI
In order to install the Verifone Hosted cart via the WordPress you navigate to the admin area. Generally located at <URL>/wp-admin. After logging in using your credentials click on “Plugins” → “Add New”.
You’ll be redirected to a new page
NOTE: The plugin folder must be in a .zip format. No other format(at this time) is accepted.
After the plugin is installed navigate to “Plugins” → “Installed Plugins” (or simply use the navigation menu on the left hand side).
Click on the “Activate” button located immediately bellow the plugin itself.
At this point the plugin is installed.
Manually
Navigate to your WordPress installation folder. Inside it there should be a folder called “wp-content”. Navigate to that folder. Inside “wp-content” another folder called “plugins” should exist. Navigate to the “plugins” folder. Once inside the “plugins” folder copy and paste ALL the “verifone-hosted” cart files as they are.
In case these folders are not present, your WordPress installation is wrong.
Once inside the “plugins” folder copy and paste ALL the “verifone-hosted” cart files as they are.
Configuration
After the installation is done the plugin also needs to be configured with the correct credentials.
To start configuring the plugin navigate to “WooCommerce” → “Settings” → “Payments” → “Verifone Hosted Cart”
The configuration page should look like this:
Each option has a tool tip which can be viewed by hovering the “?” icon.
It’s worth mentioning that Client ID, Entity ID, Payment Contract Id, 3DS Contract Id as well as their “Test” counter parts can be obtained by talking to a Verifone representative.
The 3DS enable/disable option will try to include a 3DS once the checkout happens.
The Enable/Disable cURL verify host and peer will check if both the host and the remote have https. Unless both of them have it recommended that this option remains disabled.
Enable/Disable overlay when placing order will display a simple overlay when placing an order. This is nothing more than a visual indication to the user that the request has started. It’s generally recommended to leave this active unless the theme currently used has it’s own overlay, in which case two overlays are redundant.
The Region setting will determine the region used. As it stands only NZAU has any sort of impact.
Credentials
The credentials needed to be able to accept payments via the connector can be also found in Verifone Central.
Username and password
This is the username and password used to login to Verifone Central.
Client ID
The client ID is always Verifone Central.
Entity ID
The Entity ID can be found in Verifone Central-> Administration -> Organisations. The 'Organisation ID' listed is the Entity ID required for configuring the plugin.
Payment Contract Id
The payment contract can be found in the Verifone Central -> Administration -> Payment Contract Providers. The 'Payment Provider Contract ID' listed is the Payment Contract ID required for plugin configuration.
3DS Contract Id
The 3DS Contract ID can be found in Verifone Central by navigating to Administration -> 3-D Secure Provider Contracts, then selecting the 3DS facility required. The ‘3-D Secure Contract ID’ listed is the 3DS Contract ID required for plugin configuration.
Secure Card Capture
A public key for Secure Card Capture needs to be generated to start accepting eCommerce transactions. This will ensure the any card details are encrypted in the browser, so that information can be safely passed from the merchant to Verifone.
This can be done in the Verifone Central by navigating to Administration -> Organisations, then selecting the organisation required. The Secure Card Capture area is at the bottom of the page, just click on the ‘Create new public key’ button. There is no need for this key to be used it the plugin configuration, it simply needs to be created.
Troubleshooting
Due to the large number of errors that can appear either in the installation, requests, platform incompatibility and so on this guide will not attempt to cover them all.
However it’s highly recommended to visit the WordPress support forums for any questions and concerns.
All requests that fail for whatever reason are logged in the “verifone-hosted-cart” channel.
To access the logs navigate to “WooCommerce” → “Status” → “Logs” in the WordPress backend.
In the right hand side of the screen select the log you wish to view and click on the “View” button.
If any errors have occurred, that can be logged, then they most likely will appear here.
Errors
Generally errors will initially appear due to some misconfiguration:
- Make sure that the User ID and API Key are correct
- Make sure you are not using Test Mode when if fact you meant to use Live mode
- Make sure that the Region is correct
- If using cURL verify host and peer make sure that both the host and the peer are using TLS
- If you’re using 3DS make sure that the card actually supports 3DS
- If the plugin appears to not be working make sure that it’s in the correct location
Always check the logs for more detailed information.
