OpenCart

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, we are pleased to offer the DNA Payments plugin for the Opencart platform.

Opencart is a free and Open-Source e-commerce web platform, committed to providing the best shopping cart experience for both merchants and customers. It is written in PHP, is highly customizable, supports all the major payment services, is translated in many languages and localized for many countries, has a fully responsive design (both front and back office), and more.

This guide details the steps needed to configure the DNA Payments plugin for Opencart.

2. Requirements

In order to use the DNA Payments Processing Opencart v3 plugin, please ensure that you meet the following requirements:

  1. You must have an ​ active​ and fully ​ approved​ DNA Payments Processing Account with DNA Payments Processing​. If you do not have a merchant account yet, feel free to contact our Customer Support at ​ support@dnapayments.com. If your account is still pending approval, you will need to wait before installing!

  2. Please ensure that you have the credentials detailed below:

2.1. Test

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 NumberTest terminal number issued by DNA Payments - unique to each merchant site.

2.2. Live

CredentialDescription
Live Client IDID issues by DNA Payments for each live merchant.
Live Client SecretSecret issued by DNA Payments for each live merchant.
Live Terminal NumberLive terminal number issued by DNA Payments - unique to each merchant site.

Should any of the above details be missing please contact DNA Payments.

3. Installation

DNA Payments will supply the Opencart plugin in a compressed zip file. Once the file has been obtained the below outlines the required installation steps.

  1. Log into the admin panel of your website.
  2. In the admin panel, go to "Extensions" -> "Installer".
  3. Press the "Upload" button.
  4. Select the "dna_payments.ocmod.zip" file provided by DNA Payments.

Opencart Install

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 this document.

  1. Go to menu "Extensions" -> "Extensions”.
  2. Select extension type "Payments”, scroll down and find the "DNA Payments" extension.

Opencart Extension

  1. Press the "Install" button (green).

Opencart DNA Payments

  1. After the installation, press the "Edit" button (blue).

Opencart DNA Payments Settings

  1. Fill in the "Client ID", "Client secret", "Terminal", "Test Client ID", "Test Client secret", "Test Terminal" fields with the values provided by DNA Payments.
  2. If you want to test payments, select the "Yes" option in the Test mode field. For the Live environment, select “No”.
  3. In order to show customers the “DNA Payments” payment option, select the “Enabled” option in the “Status” field.
  4. Press the "Save" button (located in the upper right corner of the page).
  5. You are ready to accept payments.

Opencart DNA Payments Settings

Detailed information about fields

FieldStateDescription
Client IDConditionalMandatory if processing on live. LIVE Client ID issued by DNA Payments
Client SecretConditionalMandatory if processing on live. LIVE Secret issued by DNA Payments
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 Client 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
Gateway Order DescriptionMandatoryMessage that will appear in the DNA Payments Merchant Portal against every transaction.
Sort orderOptionalIn what order it will be displayed to the client among other payment systems when paying for the goods.
StatusMandatoryIn order to show customers the “DNA Payments” payment option, the “Status” must be “Enabled”.
Payment form integration typeMandatoryFor now, onlye "Full Redirect" payment integration type is supported.
Order status if payment successMandatoryThe order status in Opencart shopping store when payment is successfully passed.
Payment method nameMandatoryThe text how DNA Payments option will be displayed for customers.