Step
A: Copy files and set merchant name.
First you will need to download the ePDQ
zip file to your hard drive.
You need to copy the files customppsend.php and customppreturn.php
from the vsadmin/inc/
directory of this download to the vsadmin/inc directory of your
site. Before doing so, open the
file customppsend.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.
Now copy the vsadmin/epdq directory and the file it contains to
the vsadmin directory of your
site.
Step
B: Confirm that the epdqconfirm.php file works ok.
The file vsadmin/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/vsadmin/epdq/epdqconfirm.php
What you should see is nothing. Just a blank page. If you receive
any script errors then please
get in touch with us at our support forum here . . .
http://www.ecommercetemplates.com/support/
Step
C: Protect the epdq directory with basic authentication.
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
D: Configure the Ecommerce Plus settings.
Log in to your ecommerce plus admin section and click on the "payment
providers" link on the left. Now in the list of payment providers
click on Modify for "Custom".
Enabled should be checked.
Demo Mode does not apply to ePDQ.
For Data 1 enter your ePDQ Client ID assigned to you by Barclays.
For Data 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.
For Transaction Type you should set "Authorize Capture" if
you want ePDQ to deduct funds immediately from the cardholders account. You
should set "Authorize Only" if you want ePDQ to check the cardholders
card for availability of funds only. Later using your ePDQ control panel you
will need to actually "capture" these funds. Please note that it
is now required in some countries that you only use the Authorize Capture method
if you can ship immediately or have
obtained the cardholders agreement for any delay. Otherwise use Authorize Only
and "Capture" the funds when you can despatch the goods.
Step
E: Set your own Username and Password (Taken from ePDQ epdq_mandatory.pdf
guide).
You will require a separate user account to integrate the ePDQ
CPI with the Ecommerce Plus template. This should be different
to the account provided for access to the Store Admin.
Your Store 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
F: Setup the ePDQ Configuration Pages.
Log in to the following URL using the login / password you have
created.
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 ecommerce plus payment
provider admin.
Allowed URL: The URL of your Ecommerce Plus cart page. For instance it could
be
http://www.yoursite.com/cart.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/vsadmin/epdq/epdqconfirm.php
POST User name: The username used to protect the directory containing your
thanks.asp page
POST Password: The password used to protect the directory containing your thanks.asp
page
POST Email: Merchants email address
Step
G: Testing.
Barclays ePDQ does not provide a test mode as such. 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.
Please do read our guide here on credit
card fraud.
That's all there is to it really - any comments on the set up
can be posted on our Support
Forum. |
