WooCommerce Setup Guide
Introduction
DNA Payments are committed to providing secure eCommerce processing to as many merchants as possible. One of the ways this can be achieved is by developing plugins for the global eCommerce marketplaces - allowing merchants to add payment processing to their websites quickly with minimal setup required.
Reflecting this commitment DNA Payments are pleased to offer a payment plugin for the WooCommerce platform. WooCommerce is an open-source eCommerce plugin for WordPress. It is designed for small to large-sized online merchants using WordPress. Launched in September 2011, the plugin quickly became popular for its simplicity to install and customise.
This guide details the steps needed to configure the DNA Payments plugin for WooCommerce.
Plugin Pre-requisites
Before starting the setup, process there are a small number of pre-requisites which need to be in place.
- Create a merchant account with DNA Payments - if this has not already been done please visit https://signup.dnapayments.com to complete an application.
- Create an account with Wordpress and setup your website.
- Obtain the DNA Payments WooCommerce plugin (zip file). Please rename this file to
wc-dnapyments-gateway.ziponce it has downloaded.
Credentials
- Test
- Live
| Credential | Description |
|---|---|
| Test Client ID | ID issued by DNA Payments for each test merchant. |
| Test Client Secret | Secret issued by DNA Payments for each test merchant. |
| Test Terminal ID | Test terminal ID issued by DNA Payments - unique to each merchant site. |
| Credential | Description |
|---|---|
| Live Client ID | ID issues by DNA Payments for each live merchant. |
| Live Client Secret | Secret issued by DNA Payments for each live merchant. |
| Live Terminal ID | Live terminal ID issued by DNA Payments - unique to each merchant site. |
Should any of the above details be missing please contact us.
Obtaining the DNA Payments Plugin
The plugin can be downloaded from our Github page using this link. You need to rename the downloaded zip file to wc-dnapyments-gateway.zip however before attempting to install it.
Installing the DNA Payments Plugin
DNA Payments are currently working with WooCommerce to add the plugin to the WooCommerce store. Until this has been completed the plugin will need to be manually installed. The steps for this manual installation are detailed below.
Step One
Sign into WooCommerce (test or live as required) and access the ‘Plugins’ section. At the top left-hand corner of the page there is an option to ‘Add New’. Click this option.
Step Two
On the ‘Add Plugins’ page select the ‘Upload Plugin’ option. Select the zip file provided by DNA Payments.
Step Three
Once selected WordPress will first upload, unpack, install and then validate the plugin. Once that process is complete the above screen will be shown. Click the ‘Activate Plugin’ option.
Step Four
Once the activation process is completed the DNA Payments plugin will appear in the list of options under the ‘Payments’ section as shown above. This completes the installation process.
Configuring the DNA Payments Plugin
Now the installation has been completed the DNA Payments plugin needs to be configured with the test or live credentials as outlined in section 3 of this document.
Step One
Click ‘Manage’ on the DNA Payments plugin.
Step Two
The configuration fields are then displayed. The table on the following page details the fields and provides guidance on how they should be configured.
| DNA Payments Plugin - Configuration Fields | ||
|---|---|---|
| Field | State | Description |
| Enable/Disable | Mandatory | Chooses whether to enable to disable the DNA Payments plugin |
| Description | Mandatory | Descriptive text displayed to the consumer during the checkout process |
| LIVE Client ID | Conditional | Mandatory if processing on live. LIVE Client ID issued by DNA Payments |
| LIVE Secret | Conditional | Mandatory if processing on live. LIVE Secret issued by DNA Payments |
| LIVE Terminal ID | Conditional | Mandatory if processing on live. LIVE Terminal ID issued by DNA Payments |
| Test Mode | Conditional | When selected processes all transactions against the DNA Payments test platform |
| Test Client ID | Conditional | Mandatory if processing on test. Test Client ID issued by DNA Payments |
| Test Secret | Conditional | Mandatory if processing on test. Test Secret issued by DNA Payments |
| Test Terminal ID | Conditional | Mandatory if processing on test. Test Terminal ID issued by DNA Payments |
| Back Link | Optional | Tells the DNA Payments plugin where to re-direct the consumer following the completion of a transaction |
| Failure Back Link | Optional | Tells the DNA Payments plugin where to re-direct the consumer following the completion of an unsuccessful transaction. If this field is not populated the ‘Back Link’ will be used for all transactions regardless of result. |
| Gateway Order Description | Mandatory | Message that will appear in the DNA Payments Merchant Portal against every transaction. |
Step Three
Once all the elements have been configured press the ‘Save Changes’ button. Once they have been saved successfully the above will be displayed.
Your DNA Payments plugin is now ready to use!