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/
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.
| Release date | build | Release notes |
|---|---|---|
| 2021-01-06 | verifone-woocommerce-v1.0.2%20%281%29.zip |
|
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 Common Portal.
Username and password
The username and password used to login to the Common Portal.
Client ID
The client ID is always Common Portal.
Entity ID
The payment contract can be found in the Common Portal / Administration / Organizations. When accessing this page, the Entity ID will be available in the URL:
Payment Contract Id
The payment contract can be found in the Common Portal / Administration / Payment Contract Providers. When accessing the correct payment contract, the Payment Contract Id can be found in the URL:
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 credentials are correct
- This includes payment contract ID, Username, Password, Realm, Entity ID, Client ID, etc.
- 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.
