Page tree

Versions Compared

Key

  • 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: http://servicedesk.izysync.com/servicedesk/customer/portal/57 

Table of Contents

 

Introduction

...


...

    Image Removed

...

Introduction

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.

    • View order status.

    • 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 2.1.x., 2.2.x

 

...

Configuration

Set up Barclays Account

You need to have a barclays account to use our extension. If you don't have any Barclays accounts, you can Create a new account by clicking on the following link: https://www.barclaycard.co.uk/ and choose Register

Then, you enter some personal information which helps Barclays can identify you and set up your online login details included: username and password. The system will also request you to enter an email address

to receive direct notification but don't login regularly. Next, you confirm your account by agreeing Barclaycard online Terms& Conditions and click on Register buttonIn case you already have a Barclays account, skip this step and sign in.




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


Set Configuration 

At backend, 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

 

 

Image Removed

 

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. Note:

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

...


 

 

Main Functions


  • Easily Checkout Using Credit Card 

         At frontend, customer will need to choose an item and click 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 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 RemovedAll 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 up Configuration.

 

 

 

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:
 


 

 

In case, the customers want to refund, customers must log in Barclay home page: https://mdepayments.epdq.co.uk 

NOTE:

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

 


...

Update

  • 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.

...


...

Support

  • 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