Barclays ePDQ

From Documentation

To install Barclays ePDQ you must be using v3.1.1 of 68 Classifieds or higher.

Step 1

Download the following zip file and uncrompress it then upload it to your sites includes/payment directory.

Once you have downloaded and unzipped the package you will see one file and one directory. upload/ and instructions.txt.

The upload directory should match your classifieds site structure and everything located in the proper location. You will need to upload all the files in the upload folder to the root of your site. Before doing so, open the file epdq.php in notepad and at the top you will see the line . . . $yourmerchantname = "SetMerchantNameInCustomppsend"; You need to change this to your merchant name which should be a maximum of 30 characters.

Step 2

The file epdq/epdqconfirm.php needs to know what the database connection is, so needs to "include" your database connection script. However, different hosts have different ways of configuring their security so we just have to check that everything is ok. To do this just open the file epdqconfirm.php in your web browser by entering its URL in your browser address bar. For instance it could be . . . http://www.yoursite.com/epdq/epdqconfirm.php

Step 3

Barclays ePDQ require that the directory containing your epdqconfirm.php page is protected with basic authentication. On a linux / apache server you can do this using a .htaccess file. There is a very good (although quite long) tutorial about this here . . .

http://httpd.apache.org/docs/howto/auth.html#basic

This is a more concise explanation . . .

http://www.apacheweek.com/features/userauth

Once this is done, if you now try to open the epdq/epdqconfirm.php page in your browser you should be prompted for your username / password.

Step 4

Login to your 68 Classifieds administration and go to the payment providers section. Next click modify beside the one labeled "Custom".

Active: should be checked.
Demo Mode: Does not apply to ePDQ.
Extra: For Extra enter your ePDQ Client ID assigned to you by Barclays.
Extra 2: For Extra 2 enter a secret phrase up to 16 characters known only to yourself. This can be anything you like, and the more random the better. Make it hard to reproduce . . . for instance "my45secwet8189zs". Take a note of this as we are going to enter this in the ePDQ admin panel later.

Step 5

Taken from ePDQ epdq_mandatory.pdf guide

You will require a separate user account to integrate the ePDQ CPI with your site. This should be different to the account provided for access to the Site Admin.

Your Site Admin user role is set at ePDQ Level 4. The URL you need for your unique store admin URL which was supplied by Barclays and which will be of the form . . . https://secure2.epdq.co.uk/cgi-bin/ClearCommerce_Engine/xxxxx . . . where xxxxx is your store Client ID.

1. If you do not already have your Store Admin password login details please contact the ePDQ eCommerce Support team on 0870 60 80 355.

2. From the User Configuration Page (Please see the ePDQ User Guide section "Controlling Access to your Store for details), select Add.

3. The Add User page will be displayed. Enter the details as required. The User ID must be at least 8 alpha/numeric characters and can be up to 32 characters. It must not contain any special characters (such as *,/,\_,-). A User ID such as CPIUser1 is recommended. The Password must be at least 8 alpha/numeric characters and must not contain any special characters.

Enter the Password again for validation purposes.
Enter a Password Prompt. This must not be your password and must not compromise the password (i.e. "same as user ID").
Account Name and Account Description are optional, though entering a name and description such as "CPI Integration User" and "User for CPI Access only" is recommended.
The Role is the level of permissions you wish to assign to the user. Use the drop down list to select the role of CPI Access.
Set Pagination size according to how much data you wish to have displayed on each page.

4. You should elect for an email to be sent to the merchant confirming the creation of a new user.

5. Once you have entered all the details correctly, select Add. If you have entered any details incorrectly and wish to clear all fields, select Reset.

6. The new user will now be created, and can be viewed from the User Configuration Page.

7. Log on as the new user to confirm the user had been created correctly.

8. Sign off from the engine.

Step 6.

https://cpiadmin.epdq.co.uk/cgi-bin/CcxBarclaysEpdqAdminTool.e

You want to fill out the form with the following information.

Client ID: As supplied by Barclays
User name: The one you used to log in with
Password: The one you used to log in with
Pass-phrase: A secret phrase you choose up to 16 characters. This should be the secret phrase you used for "Data 2" in the administration payment provider section.
Allowed URL: The URL of your 68 Classifieds page. For instance it could be

http://www.yoursite.com/epdq.php

Continue Option 1: Probably best set to no, but see your ePDQ documentation for more details
Continue Option 2: Probably best set to no, but see your ePDQ documentation for more details
Continue Option 3: Probably best set to no, but see your ePDQ documentation for more details
POST Order result: Yes
POST URL: The URL of your epdqconfirm.php page. This will be something like

http://www.yoursite.com/epdq/epdqconfirm.php

POST User name: The username used to protect the directory containing your thanks.php page
POST Password: The password used to protect the directory containing your thanks.php page
POST Email: Merchants email address

Testing

Barclays ePDQ does not provide a test mode. You can use the following Visa number 4111111111111111 with the expiry date 12/2004. Which will always result in a DECLINED result. However there is not a way to generate a SUCCESS result except by trying a real live transaction with your credit card. In this case Barclays recommend you set up a test product with the price £11.11 so that it is easy for them to cancel the order.

Retrieved from "http://www.68classifieds.com/documentation/index.php/Barclays_ePDQ"

Categories: Configuration | Payment Providers