Setting up ePDQ

The ePDQ payment option lets customers pay you using a credit card or debit card.

Setting up ePDQ in your shop

You can set up ePDQ payment by clicking Configuration in the shop management panel menu, clicking ePDQ, and changing the following settings:

Availability

Status
Whether ePDQ is available as a payment method.
Mode
Whether to perform test payments or live payments.
Region
Where the payment method is available — either one of the delivery regions set up in your shop or the special value Everywhere.

Configuration

PSPID
Your ePDQ PSPID. This will be supplied by ePDQ.
SHA-IN pass phrase
This is a secret value used to ensure the security of communications with ePDQ. A random value is automatically filled in for you.
SHA-OUT pass phrase
This is a secret value used to ensure the security of communications with ePDQ. A random value is automatically filled in for you.
Operation
Set to Sale to take the funds from the customer as soon as possible. Set to Authorisation to guarantee the availablity of funds for 6 days and allow funds to be taken up to 30 days after the initial transaction. Set to Pre-authorisation to check the customer details only; this does not guarantee the funds are available, but allows funds to be taken in stages and up to 90 days after the initial transaction.

Logging in to your ePDQ account

To log in to your ePDQ test account, go to the ePDQ test back office and enter your PSPID and password. To log in to your ePDQ production account, go to the ePDQ production back office and enter your PSPID and password.

Configuring your ePDQ account

Once you have logged in, select Technical information from the Configuration menu. This will show a set of tabs. Change the settings on the tabs as follows:

Global security parameters

Hash algorithm
SHA-1
Character encoding
Use the character encoding expected with the initial transaction request (depending on the URL called)

Data and origin verification

URL of the merchant page containing the payment form that will call the page: orderstandard.asp
The Referral URL from the shop management panel
SHA-IN pass phrase
The SHA-IN pass phrase from the shop management panel

Transaction feedback

Direct HTTP server-to-server request: Timing of the request
Always online (immediately after the payment to allow customisation of the response seen by the customer)
Direct HTTP server-to-server request: If the payment's status is "accepted", "on hold" or "uncertain"
The Response URL from the shop management panel
Direct HTTP server-to-server request: If the payment's status is "cancelled by the client" or "too many rejections by the acquirer"
The Response URL from the shop management panel
Direct HTTP server-to-server request: Request method
POST
I would like Barclaycard to display a "processing" message to the customer during payment processing
Check this box
I would like Barclaycard to re-launch the "end of transaction" (post-payment request/redirection) process if required.
Check this box
SHA-OUT pass phrase
The SHA-OUT pass phrase from the shop management panel
HTTP request for status changes: Timing of the request
For each offline status change (payment, cancellation, etc.)
HTTP request for status changes: URL on which the merchant wishes to receive a deferred HTTP request, should the status of a transaction change offline
The Response URL from the shop management panel

Testing and going live

To perform the test purchase, first ensure that ePDQ is set to test mode on the ePDQ page in the shop management panel. Go through the process of making a purchase from your shop, exactly as if you were a normal customer, choosing ePDQ as the payment method. You will be taken to the ePDQ test server to make a payment. The test server only accepts the following card numbers:

Card type Card number
Visa 4111 1111 1111 1111
Visa 3D 4000 0000 0000 0002
American Express 3741 1111 1111 111
MasterCard 5399 9999 9999 9999
Diners 3625 5695 5800 17
Bancontact/Mister Cash 6703 0000 0000 0000 3
Visa Purchasing 4484 1200 0000 0029
American Express Purchasing 3742 9101 9071 995

If the test transaction is successful, you will be taken back to your shop and receive an e-mail confirming the transaction. After a successful test transaction, you set up your live account by logging in to the ePDQ production back office, as described above. If your site itself is not yet live, you will need to determine your live referring URL and response URL. These will be the same as the URLs displayed in the shop management panel, but with the temporary address of your site (for example, http://s1.itseeze.co.uk/sites/example/) replaced with the address your site will use when live (for example, http://example.com/).

You can then switch to live mode on the ePDQ page in the shop management panel. Once your site itself is live you may wish to make a real purchase from your shop and then void the transaction, in order to be completely certain that your account has gone live correctly.