WooCommerce Setup Guide

1. 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.

  1. Create a merchant account with DNA Payments - if this has not already been done please visit https://signup.dnapayments.com to complete an application.
  2. Create an account with Wordpress and setup your website.
  3. Obtain the DNA Payments WooCommerce plugin (zip file).

Credentials

CredentialDescription
Test Client IDID issued by DNA Payments for each test merchant.
Test Client SecretSecret issued by DNA Payments for each test merchant.
Test Terminal IDTest terminal ID issued by DNA Payments - unique to each merchant site.

Should any of the above details be missing please contact us.

3. 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.

4. 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
FieldStateDescription
Enable/DisableMandatoryChooses whether to enable to disable the DNA Payments plugin
DescriptionMandatoryDescriptive text displayed to the consumer during the checkout process
LIVE Client IDConditionalMandatory if processing on live. LIVE Client ID issued by DNA Payments
LIVE SecretConditionalMandatory if processing on live. LIVE Secret issued by DNA Payments
LIVE Terminal IDConditionalMandatory if processing on live. LIVE Terminal ID issued by DNA Payments
Test ModeConditionalWhen selected processes all transactions against the DNA Payments test platform
Test Client IDConditionalMandatory if processing on test. Test Client ID issued by DNA Payments
Test SecretConditionalMandatory if processing on test. Test Secret issued by DNA Payments
Test Terminal IDConditionalMandatory if processing on test. Test Terminal ID issued by DNA Payments
Back LinkOptionalTells the DNA Payments plugin where to re-direct the consumer following the completion of a transaction
Failure Back LinkOptionalTells 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 DescriptionMandatoryMessage 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!