Web developer resources

Web developer resources

Integrating your ecommerce solution

Our web developer resources should tell you and your web developer everything you need to know, when integrating your new virtual payment solution into your website.

However, if you or your developer have any questions, please contact our ecommerce technical support team on 0844 824 0230  or send us an email .

1. Set-up a test account

  • Access all the features of our payment gateway
  • Experiment in a safe test environment
  • Try different payment methods
  • Make dummy payments
2. Configure your payment service in ePDQ back office

  • Manage preferences and configure the various features available in your account
  • Set up new users and manage passwords. Assign specific profiles to each user giving them only the access rights they need
3. Integrate ePDQ into your website. Choose from one of two ePDQ integration options:

  • The ePDQ hosted payment page provides control over the look and feel of the payment page, as well as easy tailoring of the payment experience, whilst we host it securely for you
  • Direct Link is the direct post API method of communicating with ePDQ. The API allows merchants to accept card payments and to query the statuses of placed orders
4. Set your payment service live

User guides

ePDQ Back Office User Guide PDF (169KB)
How to use the ePDQ back office for day-to-day activities, including how to search for transactions and issue refunds.

ePDQ e-Terminal user guide PDF (103KB)
How to process mail and telephone card-not-present transactions using the MOTO e-terminal.

ePDQ User Manager User Guide PDF (158KB)
Find out how to set up new users on your account and assign specific profiles to give each user the access rights they need.



Integration guides

Quick start guide for setting up your payment page PDF (1.08 MB)
This Quick Start guide complements the basic and advanced integration guide and we would suggest you read this first to give the basic requirements and framework along with sample code for integrating the ePDQ hosted payment page and utilising our dynamic template option to make our payment page look and feel like your website.

ePDQ Basic Integration Guide PDF (246KB)
Explains the integration of the ePDQ hosted payment page (HPP) at its most basic level to get you started. This guide is a great way to gain an understanding of the fundamental principles and requirements for integrating the ePDQ HPP, containing information on back office configurations, typical payment page redirections, common transaction statuses and the parameters you should include in an ePDQ HPP integration.

ePDQ Advanced Integration Guide PDF (532KB)
This complements the basic integration guide with information on how to integrate and control more advanced elements, such as the look and feel of the payment page with and without dynamic templates. You’ll also read about optional hidden fields, to tailor the payment experience and how to create post-sale and redirect URLs to allow you to manage your end of order processes and functions.

Direct Link QSG PDF (458KB)
This guide explains the integration of the API at its most basic level to get you started. This guide is a great way to gain an understanding of the fundamental principles and requirements for integrating our API, containing information on back office configurations, making a transaction request, example XML responses as well as a sample PHP cURL script.

ePDQ Direct Link Guide PDF (99KB)
Direct Link is the direct post API method of communicating with the ePDQ platform to accept card payments and/or querying the statuses of placed orders. The guide will discuss everything from the format of the API request and the parameters you need to include in the request to the XML parsing of the response back from the API and the most common transactions statuses and error codes.

ePDQ Direct Link with 3D Secure PDF (32KB)
Complements the Direct Link guide and explains how you can implement 3-D Secure with your Direct Link request. It details the extra request parameters required to call the 3-D Secure process and the additional parameters that are returned in the XML along with detailing the transaction flow. You should refer to the Advanced Integration Guide when integrating 3-D Secure as this process involves using the ePDQ hosted payment page to notify and redirect the cardholder back to your website.

ePDQ PayPal integration guide PDF (240KB)
This Guide explains the integration of PayPal onto the ePDQ payment page. It involves how to complete the PayPal configuration, ePDQ configuration and the complete merchant integration to make the most of this additional Payment type.



Configuration guides

ePDQ Fraud Detection Module (FDM) PDF (195KB)
In this guide you’ll find out how to configure your standard fraud settings for risk management and fraud detection. This guide covers the blocking rules that can be implemented, including ‘associated card’ rules and BIN and IP blacklists and how these can be managed in the back office.

ePDQ_Fraud Detection Module Checking (FDMC) User Guide PDF (886KB)
In addition to the risk management and fraud detection setting with the FDB (see above), the advanced fraud detection module offers a real-time service that provides all the necessary analysis information and offers fully customised safeguards for handling dubious transactions. The guide will show you how to configure the module based on the risks or past fraud issues that have been encountered by your business.

ePDQ One Page Checkout (Alias Gateway) User Guide PDF (95KB)
One page checkout allows you host your own payment page on your own domain without your server seeing or handling the card information.  This guide takes you through the process of integrating Alias Gateway and how to handle the various fields and responses.

ePDQ Push Reports PDF (78KB)
With push reports you can tailor transaction reports and have them sent to you by email or HTTP post automatically. In this guide you’ll read how to set-up, edit, resend and delete push reports.

ePDQ Scheduled Payments User Guide PDF (101KB)
Scheduled payments allow cardholders to pay for an e-commerce or MOTO purchase in several instalments, instead of one single payment. This guide explains how to set-up schedules using either the HPP or via API.

ePDQ Subscription Manager User Guide PDF (44KB)
Subscription Manager allows you to create and store recurring payments in advance, based on a date interval over a set number of occurrences.  A typical merchant using subscription manager will offer subscriptions to a product or service, e.g. a monthly magazine, for which a customer pays the same amount every month until they cancel. This guide will show you how to create, edit and delete a subscription.

ePDQ Tokenisation Alias Manager PDF (161KB)
With Alias manager you can create a unique identifier for a customer and their card, a ‘token’, which can be used to request future payments and quicken the checkout process for repeat customers. This guide will take you through token creation and management across the different  ePDQ integrations.


If you don't have Adobe Reader installed on your computer, download it here for free: Get Adobe Reader

Using ePDQ to take card payments

We want to make it simple to integrate your chosen e-commerce solution. And we’re continually working to provide you with the tools you need.

Some online stores have made it easy to start taking payments on your website, with a standard step-by-step set-up process. You’ll find them listed below as Pre-Integrated. Just select ‘Barclaycard’ from a menu of payment types and follow the simple instructions.

Other online stores use a piece of code called a Plugin, which they add to your online shop to enable payments. They’re listed below as Subscription Plugins or Free of charge Plugins. Unless you are experienced in designing websites, you will need to use a developer for this option.

eCommerce suppliers with their own proprietary solutions:

eCommerce suppliers with open source solutions:

Sample code

To make your integration process as smooth as possible please see below the latest versions of integration code - if you can’t see what you need, please get in touch.

Here are code examples in the most common programming languages to help you integrate Barclaycard ePDQ. It is recommended that you take the sample code from the download file. The scripts are presented here for reference purposes only.

Please note: By using the sample code available on this page you acknowledge that it is provided free of charge and for information purposes only.  As such, you agree that the content is indicative and not intended to provide any functionality in an actual integration situation between Barclaycard ePDQ and a third party online shop.  If re-using any of the content, you will rely on your own commercial and technical judgement as to its accuracy, completeness, quality and fitness for your purpose.

With a trial account, you can access all the features of ePDQ in our secure test environment. You’ll be able to make test transactions, with our UK-based support team on hand to help.

To request a trial account, to take a look at ePDQ, please complete this online form  to have your trial account created within minutes.

Once you have completed the online form, please use this quick start guide PDF (2.04 MB)  to assist you in configuring your ePDQ trial account. 

If you don't have Adobe Reader installed on your computer, download it here for free: Get Adobe Reader

All the logos you need for your new payment page. Not every merchant will accept all five card types so please only select and display the appropriate logos.

Download the following square images (288KB) :

Powered by Barclaycard logos - square

Download the following landscape images (217KB) :

Powered by Barclaycard logos
Please see below the individual card scheme logos, and the Verified by Visa, MasterCard SecureCode and American Express SafeKey logos:

Visa logo

Verified by Visa logo

MasterCard logo

Maestro logo

MasterCard SecureCode logo
American Express logo
American Express Safekey logo
JCB logo

PayPal logo

SmartPay developer resources

Integrating SmartPay into your website payment process