Technical information for ePDQ Merchant Payment Interface (MPI)

The MPI uses an Application Program Interface (API) which allows your website to communicate with the Barclaycard Business transaction processing engine.

Technically the integration is performed by installing our API on your server, using the Java class or C++ library files which we provide. Using the API, you create a wrapper to construct a transaction document which is sent directly into the ePDQ engine across SSL links. A similarly formatted document containing the response is sent back, allowing you to fulfil and complete the transaction.

Alternatively, you can use the direct XML input component version of the MPI, which lets you create a wrapper in any language you choose, to form an XML document according to the ePDQ Document Hierarchy (a documented version of a DTD/schema).

MPI transaction processing details

Once it's installed on your web server, the ePDQ MPI must communicate with your storefront software. In order to forward the transaction for processing, you need to pass the MPI this information:

• Type of transaction (authorisation only or authorisation and capture)
• Currency
• Transaction total
• Your web site/trading name
• Full cardholder billing and delivery details
• Unique information which we will provide for you

If you wish, you can also submit a unique order ID generated by your storefront to aid reconciliation.

The MPI will pass these details directly to the ePDQ payment engine, and return a response to your storefront.

What you need to install ePDQ MPI

Since ePDQ MPI is hosted by you, you're fully responsible for keeping your cardholders' card details safe. That means that you need to ensure your website is compliant with the Payment Card Industry Data Security Standard (PCI DSS).

Security Requirements:

If you choose to use the MPI, you must make sure you meet the security requirements set out for internet traders:

• You must be using at least 128 bit SSL encryption
• You must have a valid security certificate
• You must be using firewall technology to protect your web site
• All card transaction information must be stored on a server which is not connected to the internet

ePDQ MPI - Operating System and software compatibility

The ePDQ MPI solution is most commonly integrated using XML, by creating your own 'wrapper' for XML in the programming language of your choice.

You can process authorisation requests and refunds, and also run a multitude of reports by communicating directly with the ePDQ system over SSL.

We also supply a Java/C++ API for integrating ePDQ MPI if you prefer. Please let us know if you want to discuss this option.

The Following platforms are specifically supported for the Java/C++ API

• Solaris (Sparc) 2.7 (please note: Solaris (Intel) 2.7 is not supported)
• Windows NT 4.0/Windows 2000
• HP-UX 11.0
• Java 1.2/1.3

ePDQ MPI - Store Administration Tool

The MPI option includes access to our Store Administration Tool, which enables you to review transactions processed online.

The ePDQ Store Administration Tool has been tested on the following browsers:

• Microsoft Internet Explorer
• Google Chrome
• Mozilla Firefox
• Safari
• Opera

Browser settings

Your browser must be configured to accept cookies, and JavaScript must be enabled.