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 availability 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
America 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.