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.

Created: 09/01/2018 | By: Magenest | Support Portal:   http://servicedesk.izysync.com/servicedesk/customer/portal/37

Table of Contents
outlinetrue
stylenone


...

Introduction

Magento 2 Opayo and Subscription Extension is the most secured payment gateway in UK. Opayo Payment is formerly known as OpayoSage Pay Payment.

Image AddedImage Removed

Highlight Features 

      • Allow admins to integrate their Opayo account to their magento Magento stores.
      • Allow customers to checkout using credit card payment
      • Enable or disable the gateway.
      • Keep revenue coming consistently with the subscription plan manager.
      • Specify allowed credit card types and countries.
      • Secure payment info with iFrame payment.
      • Support multiple stores.
      • Integrate Save Card Function.
      • Choose between Authorize Only or Authorize and Capture.
      • Add a layer of security with 3D Secure Checkout.
      • Enable CVC verification.
      • Customer Customers can capture invoice invoices up to the quantity of product that they desired.
      • Admins can easily check transaction history.
      • Admins can easily manage profiles in the backend.
      • Customers can also manage their profiles and cancel them if desired. 
      • Admin can create a credit memo for refunding.
      • Easily perform Gift Aid enabled in Opayo.

      • 3D Secure version 2 available in Opayo Direct Method (Learn more about 3D secure ver 2 in here).

...

 Your store should be running on Magento 2 version 2.1.x.; 2.2.x, 2.3.x, 2.4.x

Video Tutorial


Widget Connector
width853
urlhttps://www.youtube.com/watch?v=YPIJgfm0Ljg&t=1s
height480



Configuration

 

Firstly, you have to configure the Opayo Payment Extension at Magento's back end by clicking on Stores > Configuration > Sales > Payment Methods > Opayo Payment Gateway.


Opayo Global Config

Fill in Vendor Name, Integration Key, Integration Password obtained from your Opayo credentials. (Click on Create API credentials)

In our example, we use the account and API of Opayo to implement transaction transactions in test mode. You can obtain this by going to https://test.Opayo.com/myOpayo/transactions.msp


3D SECURE VER 2

(warning) Note: 3D secure version 2 is available in Opayo Direct method only.


  • Enable 3D Secure Ver 2: choose Yes to enable 3D Secure version 2, which contains many improvements to make it easier to achieve SCA on e-commerce transactions.
  • Browser Javascript Enabled: choose Yes to enable the browser Javascript.


(plus) Turn on Test Mode when you use test credentials. Choose the Live Mode when you go live.

You can also turn on Ignore address check to skip the address and postcode check-in test mode.

Image RemovedImage Added

(plus) Vendor Name, User, and Password: The credentials you got from Opayo in the above step.

(plus) Server domain: Fill in your site domaindomain

(plus) Gateway Currency: 

  • Base Currency: the default currency of your website will be applied 
  • Front Currency: the currency of each store will be applied 

 (plus) Form Encryption Password: Obtained from Opayo. Go to Settings > Administrators > Password Details

(plus) Apply 3D Secure with 4 options: Default, Force, Disable, Force & IngoreIgnore

  • Default: Use Default My Opayo Settings
  • Force: Apply authentication even if the 3D Secure is turned off
  • Disable: Disable authentication and rules
  • Force & Ignore: Apply authentication but ignore rules

(plus) Apply AVS, CVC Check with 4 options: Default; Force; Disable; Force & IngoreIgnore

  • Default: Use Default My Opayo Settings
  • Force: Apply authentication even if the AVS, CVC Check is turned off
  • Disable: Disable authentication and rules
  • Force & Ignore: Apply authentication but ignore rules

(plus) Allow Gift Aid: Allow customers to donate to charity. Note that this function only works if your Sage account is enabled for Gift Aid.

(plus) Collect Recipient Details: 

(plus) Send transaction email: There are 3 options

  • Do not send to neither either customer or vendor email: Will not send Opayo transactions to customers or vendors via emails
  • Send customer and vendor transaction email: Will send Opayo transactions to both customers and vendors via emails
  • Send vendor email but not customer email: Will send Opayo transactions to vendor email.

(plus) Payment language: The language of the payment page (English, French, German, Spanish, Portuguese, Dutch).

(plus) Payment Surcharge Fee: You can add the extra fee for the selected payment type (MasterCard, Visa Credit, Visa Debit, American Express, Diner's Club, Maestro, VISA Electron). The fee could be defined as a fixed price or percentage of the payment.


Opayo PI Integration 

(plus) Enabled: Choose Yes to enable direct checkout for Opayo Payment

(plus) Title: The title of the payment method displayed on the checkout page.

(plus) PI Integration Key & PI Integration Password: Obtained from your Opayo account

Click on on the Check API button to check whether the API is working or not.


(plus) Enable MOTO: Allow you to make payments in the admin panel for customers buying through email or telephone.

(plus) User drop-in interface: Turn this on to show Opayo with a drop-in box.

(plus) Save Customer CreditCard Token: Allow customers to save credit card token tokens for future purchasepurchases.

 
(plus) Payment Action: You can choose between Authorize Only (Deferred) and Authorize and Capture (Payment)
  • Authorize Only: check for the card for validity but not charge the account yet until the order is approved and invoiced.
  • Authorize and Capture (Payment): charge the debit/credit card at the time of the order is placed.

(plus) New Order Status: Processing, Suspected Fraud

  • Processing: The payment is made successfully and an order invoice is issued.
  • Suspected Fraud: No invoice is issued. 

(plus)Image Removed(plus) Credit Card Types: You can choose which credit card types you want by choosing one or more items.

(plus)Image Removed(plus) Payment from Applicable Countries: 

  • All allowed countries:  Enable all allowed countries to make payment.
  • Specific Countries: Restrict some countries by unselecting them from the Payment from Specific Countries.

(plus)Image Removed In addition, you can add/edit the Instructions to instruct customers on how to do the payment.

(plus)Image Removed(plus) Sort Order: The order of the payment method that will be displayed on the checkout page.

(plus)Image Removed(plus) Minimum Order in Total: If the order value is less than this figure, the payment method will not be displayed on the checkout page.

(plus)Image Removed(plus) Maximum Order in Total: If the order value is bigger than this figure, the payment method will not be displayed on the checkout page.


Save Configuration.

Integrate with Paypal

To integrate Opayo Payment with your Paypal, please navigate to https://test.Opayo.com/myOpayo/transactions.msp

On the left menu column, choose Pay methods then add your Paypal account on the right in the Use Paypal Express Checkout with Opayo

Please read these documents from Opayo for more details: 

https://www.Opayo.co.uk/support/12/36/adding-paypal-to-your-test-account

https://www.Opayo.co.uk/support/12/36/enabling-sage-pay-on-your-paypal-test-account

https://www.Opayo.co.uk/support/16/36/linking-paypal-to-your-live-account

 

Create User in Opayo

In Opayo page, choose Users in the Settings, then create an a user by clicking on the New user button. You will use this user account to link Paypal with your Opayo

Opayo Form Integration/Paypal

(plus) Enabled: Enable Opayo Form with Paypal option

(plus)Title: The title of the payment method displayed on the checkout page

(plus)Payment Action: You can choose between Authorize Only (Deferred) and Authorize and Capture (Payment)

  • Authorize Only: check for the card for validity but not charge the account yet until the order is approved and invoiced.
  • Authorize and Capture (Payment): charge the debit/credit card at the time of the order is placed.



(plus) New Order Status: Processing, Suspected Fraud

  • Processing: The payment is made successfully and an order invoice is issued.
  • Suspected Fraud: No invoice is issued. 

(plus)Image Removed(plus) Payment from Applicable Countries: 

  • All allowed countries:  Enable all allowed countries to make payment.
  • Specific Countries: Restrict some countries by unselecting them from the Payment from Specific Countries.

(plus)Image Removed(plus) Sort Order: The order of the payment method that will be displayed on the checkout page.

(plus)Image Removed(plus) Minimum Order in Total: If the order value is less than this figure, the payment method will not be displayed on the checkout page.

(plus)Image Removed(plus) Maximum Order in Total: If the order value is bigger than this figure, the payment method will not be displayed on the checkout page.


Opayo Server Integration

(plus) Enabled: Enable Opayo Server

(plus) Title: The title of the payment method displayed on the checkout page

(plus) Payment Action: You can choose between Authorize Only (Deferred) and Authorize and Capture (Payment)

  • Authorize Only: check for the card for validity but not charge the account yet until the order is approved and invoiced.
  • Authorize and Capture (Payment): charge the debit/credit card at the time of the order is placed.

 


(plus) New Order Status: Processing, Suspected Fraud

  • Processing: The payment is made successfully and an order invoice is issued.
  • Suspected Fraud: No invoice is issued. 

(plus)Image Removed(plus) Payment from Applicable Countries: 

  • All allowed countries:  Enable all allowed countries to make payment.
  • Specific Countries: Restrict some countries by unselecting them from the Payment from Specific Countries.

(plus)Image Removed(plus) Sort Order: The order of the payment method that will be displayed on the checkout page.

(plus)Image Removed(plus) Minimum Order in Total: If the order value is less than this figure, the payment method will not be displayed on the checkout page.

(plus)Image RemovedMaximum (plus) Maximum Order in Total: If the order value is bigger than this figure, the payment method will not be displayed on the checkout page.


Opayo Direct Integration

(plus) Enabled: Enable Opayo Direct Payment

(plus) Title: The title of the payment method displayed on the checkout page

(plus) Payment Action: You can choose between Authorize Only (Deferred) and Authorize and Capture (Payment)

  • Authorize Only: check for the card for validity but not charge the account yet until the order is approved and invoiced.
  • Authorize and Capture (Payment): charge the debit/credit card at the time of the order is placed.

 

 


(plus) New Order Status: Processing, Suspected Fraud

  • Processing: The payment is made successfully and an order invoice is issued.
  • Suspected Fraud: No invoice is issued. 

(plus)Image Removed(plus) Payment from Applicable Countries: 

  • All allowed countries:  Enable all allowed countries to make payment.
  • Specific Countries: Restrict some countries by unselecting them from the Payment from Specific Countries.

(plus)Image RemovedSort (plus) Sort Order: The order of the payment method that will be displayed on the checkout page.

(plus)Image Removed(plus) Minimum Order in Total: If the order value is less than this figure, the payment method will not be displayed on the checkout page.

(plus)Image Removed(plus) Maximum Order in Total: If the order value is bigger than this figure, the payment method will not be displayed on the checkout page.


Opayo PayPal

(plus) Enabled: Enable Opayo PayPal Payment

(plus) Title: The title of the payment method displayed on the checkout page

(plus) Payment Action: You can choose between Authorize Only (Deferred) and Authorize and Capture (Payment)

  • Authorize Only: check for the card for validity but not charge the account yet until the order is approved and invoiced.
  • Authorize and Capture (Payment): charge the debit/credit card at the time of the order is placed.

 

(plus) New Order Status: Processing, Suspected Fraud

  • Processing: The payment is made successfully and an order invoice is issued.
  • Suspected Fraud: No invoice is issued. 

(plus)Image Removed(plus) Payment from Applicable Countries: 

  • All allowed countries:  Enable all allowed countries to make payment.
  • Specific Countries: Restrict some countries by unselecting them from the Payment from Specific Countries.

(plus)Image Removed(plus) Sort Order: The order of the payment method that will be displayed on the checkout page.

(plus)Image Removed(plus) Minimum Order in Total: If the order value is less than this figure, the payment method will not be displayed on the checkout page.

(plus)Image RemovedMaximum (plus) Maximum Order in Total: If the order value is bigger than this figure, the payment method will not be displayed on the checkout page.


Config for the subscription product

...

  • To create a subscription product, click on Products > Catalog 
  • On the right side, press Add product button, click on the arrow and choose among 6 types of product: Simple Product, Configurable Product, Grouped Product, Virual Virtual Product, Bundle Product, Downloadable Product.
  • Then, the New Product page will be shown.
  • In the Opayo Subscriptions Options, there are two sections: General Config, Options
    • General Config: Enable the subscription mode of the product.
    • Options: Click Add option to add subscription plan for the product.

...

  • Customers can add their desired items to the shopping cart by clicking on Add to Cart button.
  • Then, the customer can go to the checkout page easily with the Checkout Button in the drop down of the shopping cart icon .
  • Next. The customer fills in his/her shipping address and selects the payment method.

...

  • Mark the checkbox "My billing and shipping addresses are the same" if the shipping address and the billing address are not different.
  • If they are different, fill in the billing address then click "Update".

In this section, the customer will enter his/her credit card info into a drop-in that is more secured.

...

Customers can see the cards that they used by clicking My Account > My Saved Card Identifiers:


Image Modified

View Order

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

...

If you set the Payment Action as Authorize Only, the invoice will not be created. You have to capture invoice in your request. However, the quantity of the products in the new invoice must be smaller than or equal to the pre-order.

...

Click on View button to see the details of invoice that you want.

Image Modified

You can change the column content by clicking on the Columns icon on the top right. Next to it is the Export icon that allows you to export the invoices list into CSV and XML files.

...

On the right side, there are three important buttons: Send an email, Credit memo, and Print

...

To view transactions in Opayo, log in to Magento backend and choose Opayo Payment Gateway > Transactions

...