Page tree

Versions Compared


  • This line was added.
  • This line was removed.
  • Formatting was changed.


Thank you for purchasing our extension. If you have any questions that are beyond the scope of this document, do not hesitate to leave us an email via our email address below.: [email protected]

Created: 11/08/2016 | By: Magenest | Support Portal: 

Table of Contents



Image Removed

Barclays Payment Gateway extension for Magento 2 by Magenest is the great tool synchronizing from your Magento 2 store to the Barclays Payment Gateway.




Barclays is a British multinational banking and financial services company headquartered in London. It is a universal bank with operations in retail, wholesale and investment banking, as well as wealth management, mortgage lending and credit cards. It has operations in over 50 countries and territories and has around 48 million customers. 

Therefore, Magenest has created  Barclaycard ePDQ Payment Gateway to be able to interact between Barclay bank and customers in the most convenient way.

Image Added

Features For Admins

  • A lot of features is included in the extension that you can tweak to make it best suit your business, including:

    • Choose between Authorize Only or Authorize and Capture.

    • New View order status.

    • Email Check email customer.

    • Allowed credit card types.

    • Enable 3D Secure
    • Enable CVC verification.Allowed country.

    • Restrict unwanted countries from making payment

    • Order total threshold.

    • Submit invoice from backend

Features For Customers

  • The primary aim of the extension is to deliver the most fluent and effortless payment experience to the customers:

    • Easily checkout using credit card.

    • Purchase through telephones or emails

System Requirements

 Your store should be running on Magento 2 Community Edition version  2.01.x or ., 2.12.x.




Set up Barclays Account

You need to have a barclays account to use our extension. If you don't have not any Barclays accounts, you need to create can Create a new account by clicking on the following link:, choose a new account to set up  and choose Register

In case you already have a Barclays account, skip this step and sign in.

If you had have a barclays Barclays account, you only  sign in to your account. 

Set Configuration 

At back end, admin need to configure some fields to connect between your magento site and the Barclays  account. 

Firstly, admin click on  

(plus) General Settings:

Go to Stores > Configuration > Sales > Payment Methods

In addition, admin can set information for: Title, PSPID, User Id, Password, SHA-in pass phrase, SHA-out pass phrase, Hash algorithm, Default Settlement Currency, Payment Description, Language Code, Payment Action, , New Order Status, Sandbox Mode Enabled, Url Production, Url Maintenance Production, Email Customer, Payment Instructions Helper, Button BG ColorButton text Color.  

Image Removed

PSID: the username you use to login to the ePDQ Merchant services pages

Hash algorithmMagento Edition hashes all data that does not require decryption by using a strong SHA-256 hashing algorithm instead of the previously used MD5.

passwords will be hashed using the new algorithm whenever they are entered by customers, and all new passwords will be hashed using the SHA-256 or SHA-512 algorithm.

Image Added

Image Added

Hash algorithm

Hash algorithm need to same with Hash algorithm in barclay

(Barclaycard ePDQ) Sha-out phrase can get in "Configuration->Technical information->Global security parameters"

Image Added

Image Added

(plus) ePDQ Hosted Payment Page integration (Recommend Integration)

Barclaycard configuration

Fill out these 3 URLs in Barclay

  • Main URL 

Go to Configuration > Technical Information > Data and origin verification.

Fill main URL in "Checks for e-Commerce"

Image Added

  • Notification URL and Notification error URL 

In Barclaycard, go to Configuration -> Technical Information -> Transaction feedback -> Go to "Direct HTTP server-to-server request"  and fill the Notification and Notification Error URLs from Magento backend in.

And click in check box "Online"  

Both Notification URL and Notification error URL are HTTPs protocol. 

If using HTTP, you will not receive response from Barclay, then orders cannot handle the payment result. 

You should choose some vaiables in "Dynamic e-Commerce parameters", but should not choose all of them.  

Image Added

  • SHA-in pass phrase 

Go to Configuration -> Technical Information -> Data and origin verification. in Barclaycard website

Fill password in "SHA-in pass phrase"

And back to Magento backend configuration, fill that pass to "SHA-in pass phrase"

Image Added

Fill password in the SHA-in pass phrase 

Image Added 

  • SHA-out pass phrase

Go to Configuration->Technical information->Transaction feedback -> Find "Security for request parameters" and fill password in the SHA-OUT pass pharse

Image Added

Fill password in the SHA-out pass phrase

Image Added

  • Configure color of Static check out page 

Image Added

  • Configure Transaction feedback response
    In Dynamic e-Commerce parameters, we recommend that you shouldn't choose all parameter from the box. First, you should choose 4 default parameters, then add other necessary ones in order to avoid validation response error.

Image Added

(plus) Barclay ePDQ Direct Link Integration: 

Image Added

  • SHA-IN pass phrase, make sure to have a strong value here. You will need to copy this value to Magento.

    If your ePDQ one subscription supports DirectLink, then you will find these extra options:

  •   IP address of the server calling the APIs: in order to use DirectLink you must enter your IP address(es) here, separated with a ; (semi-colon). 
  •   SHA-IN pass phrase: this is another SHA field, but specifically for DirectLink payments. Make sure to enter a strong value here. You must later copy this value to Magento:
  • Create User for direct link method

Login Barclay -> Configuration -> Users -> Click "New user"

In Create user form, after filling out your information, click "Related FQA" and click "Create" button.

Image Added

Image Added

You have to Click "Special for API"

Image Added

All of instructions of how to get the needed information are right under each field.

When done, please press Save Config, your configuration is ready to use. 



In Barclaycard merchant site, you need to config these 4 urls with the following form





Main Functions

  • Easily Checkout Using Credit Card 

At front end, customer will need to choose an item and click          At frontend, customer can add their wanted item to cart by clicking on Add to Cart button. 

Image RemovedImage Added

     Then, go to checkout and select Barclays  Credit Card Payment instead of Check/Money order. 


Image Removed


After clicking Continue to Barclaycard ePDQ, you will be transmitted to Barclaycard payment page

Image Removed Barclays ePDQ Payment 

     There are two methods for customer to pay: Barclaycard ePDQ Direct Link Payment and Barclaycard ePDQ Payment: 

     (plus) Barclaycard ePDQ Direct Link Payment:

          Customer enter compulsory information such as: Credit card number, Expiration date, Card Verification Number and click Place Order button. 

Image Added

         The system will inform order number of the customer in home page and send email to confirm via email. Payment is successful!

Image Added

 (plus) Barclaycard ePDQ Payment:

        Customers follow the below picture. This method is similar to Barclaycard ePDQ Direct Link Payment: 

                                                                                   Image Added

Image Added

Image Added

      All of the payment's process operate in Barclaycard's payment site, not in Magento.

(plus) View Order:

 When the transaction is completed, customers can review their orders by clicking Sales > Orders >View

Image Added

Image Added

(plus) Set Payment Action:

After successful payment, at Payments Action tab of Barclays , the order will be updated corresponding with two options when admin set at up Configuration.


Image Removed



Authorize and Capture (Sale) and Authorize Only


If you choose Authorize Only in backend, click the Pay ID in the list above, and then choose the action you want to do:




If the customers want to refund, admin can click Delete Payment.


All of the payment's process operate in Barclaycard's payment site, not in Magento.




  • When a new update is available, we will provide you with a new package containing our updated extension.
  • You will have to delete the module directory and repeat the installing steps above.
  • Flush the config cache. Your store and newly installed module should be working as expected.




  • We will reply to support requests after within 2 business days.
  • We will offer lifetime free update and 6 months free support for all of our paid products. Support includes answering questions related to our products, bug/error fixing to make sure our products fit well in your site exactly like our demo.
  • Support DOES NOT include other series such as customizing our products, installation and uninstallation service.




Once again, thank you for purchasing our extension. If you have any questions relating to this extension, please do not hesitate to contact us for support.Magenest