Magento Modules‎ > ‎

Barclaycard ePDQ Integration

This guide will walk you through setting up the PSPID style Barclays ePDQ integration that was recently introduced by Barclaycard. Please follow these steps before contacting support@junowebdesign.com.

Installation & Setup
  • Download the module:
    1. Once you have successfully purchased the module in the Juno Magento Module store you will be able to access your download via the "My Account" section of the website. 
    2. Vist http://magento.junowebdesign.com/ and login using the link in the top right corner.
    3. Once logged into your account you will see the "My Downloads" link in the left navigation. Click on this link.
    4. Now on the downloads page you will see the downloadable products that are linked to your account.
    5. Click on the appropriate module and download the .tar file to your computer.

  • Install the module:
    1. Installation of your module should be done via Magento Connect. This can be location on your Magento store by visiting http://www.YOURURL.com/downloader/
    2. Once you visit this URL, please login using your standard Magento admin credentials to login.
    3. When you are logged in you should use the "Direct package file upload." link. Browse your hard drive to locate the module file that you downloaded previously.
    4. Once you have selected the module. Press "Upload". 
    5. The module will now be installed via Magento connect. 
    6. As a note, you can also unzip the tar file and upload manually via FTP, however installation via Magento Connect is recommended. 

  • Configure the Barclaycard side:
    1. Configuration on the Barclaycard side of things is essential to the module working. Please go through all of these steps before configuring on the Magento side.
    2. First of all you will need to login the the Barclaycard configuration area, the URLs for this control panel are:
      1. https://mdepayments.epdq.co.uk/ncol/prod/backoffice/container/
    3. To login to the above URLs you will need your PSPID and your account password.
    4. Once logged in, please navigate to the "Technical" link which is under the "Configuration" tab. On the first page, please match the settings to the screenshot below, (unless you have need to do otherwise)

    5. IMPORTANT! - Your MUST press the green confirm and go to button at the bottom of each configuration page in order to save the configuration, even if you havent changed any of the settings on the page, always press the green button at the bottom of the page!

    6. Global Security Parameters - please match the settings to the screenshot below, (unless you have need to do otherwise):
    7. Payment Page Layout - please match the settings to the screenshot below, (unless you have need to do otherwise):
      On this page it is important that you set the "Back Button" redirect option. The URL path of this on your server is: /barclays/process/abort/, therefore you should enter this settings as http://www.YOURURL.com/barclays/process/abort/ ensuring that you replace "YOURURL.com" with your actual domain name.
    8. Data and origin verification - please match the settings to the screenshot below, (unless you have need to do otherwise):
      From this settings page there are two very important settings:
      • Referral URL - The referral URL is very important as it is the URL that Barclaycard will accept incoming transaction from. The URL path for this on your server is: /barclays/process/send/ therefore, this setting should be set to: http://www.YOURURL.com/barclays/process/send/ ensuring that you replace "YOURURL.com" with your actual domain name.
      • Passphrase - You will need to note down what your Passphrase is as you will need to enter it in your Magento control panel.
    9. Transaction feedback - please match the settings to the screenshot below, (unless you have need to do otherwise):
      From this page, the following setting need to be configured.
      • Accept URL - The URL path for this on your server is: /barclays/process/success/ therefore, this setting should be set to: http://www.YOURURL.com/barclays/process/success/ ensuring that you replace "YOURURL.com" with your actual domain name. 
      • Decline URL - The URL path for this on your server is: /barclays/process/abort/ therefore, this setting should be set to: http://www.YOURURL.com/barclays/process/abort/ ensuring that you replace "YOURURL.com" with your actual domain name. 
      • Exception URL - The URL path for this on your server is: /barclays/process/abort/ therefore, this setting should be set to: http://www.YOURURL.com/barclays/process/abort/ ensuring that you replace "YOURURL.com" with your actual domain name. 
      • Cancel URL - The URL path for this on your server is: /barclays/process/abort/ therefore, this setting should be set to: http://www.YOURURL.com/barclays/process/abort/ ensuring that you replace "YOURURL.com" with your actual domain name. 
      • Transaction Feedback - Please ensure that you tick the "I want to receive transaction feedback parameters on the redirection URL's.
    10. Transactional emails - please match the settings to the screenshot below, (unless you have need to do otherwise):
      It is important to enter your email address in these settings to catch any error emails that Barclaycard may send.
    11. Test Info - please match the settings to the screenshot below, (unless you have need to do otherwise):
      ENSURE! - That you press the green button at the bottom of this page!
    12. To Summarise

  • Configure the Magento side:
    1. Now that the module has been configured on the Barclays side of things we can configure the Magento side. 
    2. Login to your Magento admin panel and navigate to the following section: Admin > System > Configuration > Payment Methods > Barclaycard Integration 

    3. The following settings will need to be configured:
      • Enabled - If the module is enabled or not, this should be set to Yes to allow transactions.
      • Licence Key - This is the serial code for the module to be used on your specified domain name, this is obtainable in your account area of http://magento.junowebdesign.com/ or by emailing support@junowebdesign.com. If you require additional development URLs please email us.
      • Title - The title of the payment method that the user will see at the checkout.
      • Status - This setting will switch the module between test mode and live move.
      • PSPID - This is your unique barclays PSPID number, something like epdq1234567
      • Passphrase - This is your chosen passphrase as setup in the Barclaycard configuration above.
      • Background Colour, Text Colour, Table Background Colour, Table Text Colour, Button Background Colour - These are new settings introduced by Barclaycard with the new type of integration. The colour can control how the payment pages on the Barclaycard server look like.
      • Logo Image Path - This can be used to specify a graphic logo for your business. It should be noted that for Barclays to use your logo it has to be on a secure (https://) url. If you do not have a SSL certificate then this cannot be used.
      • Font Face - This is the font face that is to be used on the payment pages.
      • Sort Order - This is the sort order of the payment method on the checkout of your store.
    4. Once you have entered the settings above, press the save button. This will save the settings and you should be ready to test.

  • Testing & Further steps:
    1. Now that you have installed the module you will need to test transactions. If this is a new setup Barclaycard will also required to complete transactions in test mode before they set your account live. 
    2. Tests can be completed by visting your store, adding a item to the basket and then going through the checkout ensuring that you select the Barclaycard payment method. Test card details should be used when making the transaction. A test card number that can be used is 4444333322221111 with any future expiry date or CVV number.

Troubleshooting
  • Error messages that end in /r/
    • If you are receiving the error massage that ends in /r/ this means that your "Referral URL" in the barclaycard configuration is wrong. Barclaycard is showing this message as your referring URL is different to the one you typed into the config page. 9 times out of 10 this can be fixed by adding /index.php/ into your referral URL. For example try changing: yoursite.com/barclays/process/send/ to yoursite.com/index.php/barclays/process/send/. Please try this before contacting.
  • Error messages that end in /s/
    • If you are seeing /s/ at the end of the error message when you get to the Barclaycard page you have a error with your SHA passphrase. Please try re-entering your passphrases on Magento and Barclaycard to fix.
  • Redirected to basket on checkout.
    • Please ensure that your payment method is set to "Sale" and not "Authorisation", if this fails please upgrade your module above 2.0.1

Thanks for using the help guide.
Copyright 2012 Juno Media - Do not reproduce without written consent.
Comments