Overview

ePDQ is a payment gateway offered by Barclaycard, a bank in the UK. You can read more about ePDQ here:

http://www.barclaycard.co.uk/business/accepting-payments/e-commerce-services-for-sme/extraplus

 

Squirrelcart supports two different connection options offered by ePDQ:

Direct Link (API)
With this option, credit card information is collected on your website.

e-Commerce
With this option, credit card information is collected on the gateway's website.

 

Instructions for enabling each method can be found below.

Direct Link uses Squirrelcart's "Store Hosted / Server to Gateway" connection method. Optionally, Squirrelcart supports their 3D secure feature, used to authenticate credit cards that have been enrolled in the 3D secure service.

Requirements

• CURL or fsockopen support
• SSL certificate
• TLS 1.0 support is required for the 3D Secure feature, as of this writing (5/15/2015). This protocol is deprecated. TLS 1.0 support may not be needed in the future. Check with your web host to determine if your web server supports TLS 1.0.
• ePDQ user account, with Direct Link enabled.
  If you wish to use the 3D secure feature, "Direct Link 3D" must also be enabled on your account. Contact ePDQ support to have these features enabled.

3D secure process

With DirectLink, if you enable 3D secure and a credit card is entered that is NOT enrolled in 3D secure, the order will complete normally.

If a credit card is entered that is enrolled in 3D secure, the customer will be taken to a page where they can enter their verification code to confirm that they are the owner of the card. Upon successful verification, the customer is returned to the thank you page on your site and the order is completed. Note that the thank you page is actually requested by ePDQ's servers, and the HTML is presented to them while still being at the payment gateway URL.

3D secure is optional. The setup instructions for DirectLink below include additional steps for enabling 3D secure.

Setup Instructions

1. Enter Squirrelcart's control panel

2. Click Tools > Diagnostics > CURL & OpenSSL

3. Click the second link, under "To test a secure HTTPS (SSL) connection via curl...". This will perform a request back to our website to test CURL. Your server's IP address will be shown. Write it down.

4. Login to the ePDQ control panel: https://payments.epdq.co.uk/ncol/PROD/admin_epdq.asp

5. Click Configuration > Technical Information

6. Click Data and Origin Verification

7. Enter your server's IP address in the IP address field, under the Checks for Barclaycard Direct Link and Barclaycard Batch (Automatic) heading

8. In the same section, enter a 16 character unique string in the SHA-IN pass phrase field. You will need this value again, write it down or save it to a text file.

9. Click SAVE

10. Each credit card type you wish to accept must be enabled in your ePDQ control panel. Click Configuration > Payment Methods and use the links contained within. Contact ePDQ support if you need assistance with this.
    
    If you wish to enable 3D secure, you will need to enable it for each credit card payment method on this same page, as follows:
    
    a. Click the edit link for the payment method
    b. Select the 3D Secure Activation tab
    c. Under Activation , choose the option to activate full 3D (3-D Secure, Secure Code, ...)
    d. Save changes

11. Click Configuration > Users

12. Click NEW USER

13. Enter a value for UserID (write it down or save it to a text file)

14. Enter a value for User's name

15. Enter a value for E-mail address

16. Check the Special user for API (no access to admin.) field.

17. Enter your password again in the To confirm the modification, please enter your own password field

18. Keep the default values for the remaining fields

19. Click SAVE

20. You will be prompted to enter your own password, and a new password for this new user. Write down the new password or save it to a text file.

21. If you wish to enable the 3D secure feature:
    
    a. Click Configuration > Technical Information
    
    b. Click the Transaction Feedback tab
    
    c. Below the heading e-Commerce, you'll find a subheading of HTTP redirection in the browser. In that section, check both of these checkboxes:
        _ I would like to receive transaction feedback parameters on the redirection URLs.
    
        _ I would like Barclaycard to display a short text to the customer on the secure payment page if a redirection to my website
           is detected immediately after the payment process.
    
    d. Below those fields, you'll find a section labeled Direct HTTP server-to-server request.  In that section, make the following changes:
    
        - Set Timing of the request to Always online
    
        - For both URL fields below that setting, enter the secure URL to your storefront page. Example:
          https://www.example.com/store.php
    
        - Set Request method to POST
    
    e. Below the heading All transaction submission modes, you'll find a section labeled Security for request parameters.
        Enter a unique value in the SHA-OUT pass phrase field. You will need to save this value for later use.
    
    f. Click the SAVE button
    

22. Open the Payment Gateways table
    

23. Click on the record row labeled ePDQ (Direct Link, Barclays UK)
24. Enter your ePDQ PSPID in the PSPID field. This is the same username you used to login for step #4 above.
25. Enter the user ID you created in the User ID field.
26. Enter the password for that account in the Password field.
27. Enter the SHA-IN Passphrase from step #8 
28. If you wish to use 3D secure, enter the SHA-OUT Passhphrase you configured earlier in the SHA-Out Passhprase field, and check the 3D Secure checkbox.
29. Choose your transaction type using the Transaction Type field
30. Set the Connection Method field to Store Hosted / Server to Gateway
31. Set the Currency Code field.
32. Check the Enabled field
33. Click

 

ePDQ e-Commerce

ePDQ e-Commerce uses Squirrelcart's "Gateway Hosted" connection method.

Requirements

• SSL certificate
• TLS 1.0 support is required. This protocol is deprecated. TLS 1.0 support may not be needed in the future. Check with your web host to determine if your web server supports TLS 1.0.
• ePDQ user account, with "e-Commerce" enabled.
  

Setup Instructions

1. Enter Squirrelcart's control panel

2. Login to the ePDQ control panel: https://payments.epdq.co.uk/ncol/PROD/admin_epdq.asp

3. Click Configuration > Technical Information

4. Click Data and Origin Verification

5. Locate the Checks for e-Commerce section of the form

6. Enter your secure storefront URL in the field labeled:
   URL of the merchant page containing the payment form that will call the page: orderstandard.asp
   
   Example: https://www.example.com/store.php

7. In the same section, enter a 16 character unique string in the SHA-IN pass phrase field. You will need this value again, write it down or save it to a text file.

8. Click SAVE

9. Each credit card type you wish to accept must be enabled in your ePDQ control panel. Click Configuration > Payment Methods and use the links contained within. Contact ePDQ support if you need assistance with this.
   
   If you wish to enable 3D secure, you will need to enable it for each credit card payment method on this same page, as follows:
   
   a. Click the edit link for the payment method
   b. Select the 3D Secure Activation tab
   c. Under Activation , choose the option to activate full 3D (3-D Secure, Secure Code, ...)
   d. Save changes

10. Click Configuration > Users

11. Click NEW USER

12. Enter a value for UserID (write it down or save it to a text file)

13. Enter a value for User's name

14. Enter a value for E-mail address

15. Check the Special user for API (no access to admin.) field.

16. Enter your password again in the To confirm the modification, please enter your own password field

17. Keep the default values for the remaining fields

18. Click SAVE

19. You will be prompted to enter your own password, and a new password for this new user. Write down the new password or save it to a text file.

20. Click Configuration > Technical Information

21. Click the Transaction Feedback tab

22. Below the heading e-Commerce, you'll find a subheading of HTTP redirection in the browser. In that section, check both of these checkboxes:
     _ I would like to receive transaction feedback parameters on the redirection URLs.
    
     _ I would like Barclaycard to display a short text to the customer on the secure payment page if a redirection to my website
        is detected immediately after the payment process.

23. Below those fields, you'll find a section labeled Direct HTTP server-to-server request.  In that section, make the following changes:
    
        - Set Timing of the request to Always online
    
        - For both URL fields below that setting, enter the secure URL to your storefront page. Example:
          https://www.example.com/store.php
    
        - Set Request method to POST

24. Below the heading All transaction submission modes, you'll find a section labeled Security for request parameters. 
    Enter a unique value in the SHA-OUT pass phrase field. You will need to save this value for later use.

25. Click the SAVE button
    

26. Open the Payment Gateways table
    

27. Click on the record row labeled ePDQ (Direct Link, Barclays UK)
28. Enter your ePDQ PSPID in the PSPID field. This is the same username you used to login for step #4 above.
29. Enter the user ID you created in the User ID field.
30. Enter the password for that account in the Password field.
31. Enter the SHA-IN Passphrase from step #8 
32. Enter the SHA-OUT Passhphrase you configured earlier in the SHA-Out Passhprase field.
33. Choose your transaction type using the Transaction Type field
34. Set the Connection Method field to Gateway Hosted 
35. Set the Currency Code field.
36. Check the Enabled field
37. Click

 

 

 

---

© 2001-2017 Lighthouse Development. All Rights Reserved.