Magento 2.X Community Edition – (New) Openpay Widget

Integration Guide

Objectives and Target Audience

This guide describes the process of installing and configuring the Openpay Widget / Extension to Magento 2.X Community Edition. You should have an existing Magento installed.

This widget explains how Openpay is a flexible, interest-free payment method. It showcases the minimum and maximum order value, allowing the user to choose an option to pay weekly or fortnightly, over available months.

What is Openpay Widget?

Openpay Widgets is a Magento Extension with a predefined set of configuration options.

Placement of the Widgets

Openpay Widget plugin is a set of widgets, when installed and activated will show the widgets on the following pages:

  • Info Belt – Top section of the HomePage
  • Product Catalog / Listing Page
  • Product Detail Page
  • Cart Page
  • Checkout Page
  • Landing Page

Installing and Configuring Openpay Widgets on Magento 2


Before installing the Openpay module, make sure that your web server meets the following criteria:

  • There should be an existing Magento installation on your web server. The Openpay module is compatible with Magento version 2.x. The installation procedure described here has been tested on Magento version 2.x
  • Supported Web Servers: Apache / nginx
  • SSL: A valid security certificate is required to work over a secure channel (HTTPS) from the Magento Admin Panel or while submitting form data from the store‐front. Self‐signed SSL certificates are not supported
  • MySQL database with sample data
  • At least 7.00 or the later version of PHP, MySQL and web browser
  • Curl (version 7.20.0 ‐ 7.44.0)

For further details on PHP compatibility, MySQL, supported Web servers and other requirements, refer to the Magento website:

Running Magento on a Windows Server

Magento can be run on a Windows server.

Installation Steps for Magento 2.1.x, 2.2.x, 2.3.x and 2.4.x

To install the extension, run the composer commands “composer require opy/widgets”

Using server SSH Access, on command line, go to the project root and run the below commands to install the Openpay Widget module:

  • php bin/magento setup:upgrade
  • php bin/magento setup:static-content:deploy -f
  • php bin/magento cache:flush


Admin Setup

Log in to your Magento admin.

Navigate to Stores > Settings > Configuration

Check the status of the module by running this command: php bin/magento module:status. If the Openpay_Widgets appears on the ‘List of enabled modules’, then the module is running properly.

Expand Openpay > Widgets > General Configuration > Enable Widgets > Yes > Save Config

Magento 2 - Enable Widget

To set up ‘Openpay Widgets’, fill out the fields as per your Openpay account configuration. (This information will be provided by your Openpay Ecommerce Manager or Account Manager).

Important note:
Check with Openpay / Ecommerce Manager for your Plan Tiers configuration.



General Configuration

Enable Widget Set to ‘Yes’
Region Select Australia or United Kingdom (as per your contract)
Plan Tiers Select months (as provided by Openpay eg 2, 3 or 4, multiple selections could be done)
Minimum Order Value Will automatically populated if the Openpay Payment Method extension is installed
Maximum Order Value Will automatically populated if the Openpay Payment Method extension is installed

Info Belt Widget

Show Info Belt Widget There are two options to display the Info Belt on top of the website head section.
Home Page or Across the Site. Select your preferred option from the dropdown
Info Belt Widget Color Select an option from ‘Amber’, ‘Grey’ or ‘White’, one that suits your website theme
Info Belt Widget Sticky If your website theme has a sticky menu select ‘Yes’ else select ‘No’

Product Listing / Catalogue Page Widget

Show Catalog Page Widget Select ‘Yes’ to display Catalog Page Widget on product listing / catalog page
Show Openpay Logo on Catalog Widget Select ‘Yes’ to display the Openpay logo on Catalog Page Widget for product listing / catalog page
Catalog Page Widget Logo Two Openpay logo options available to choose from – Grey or White

Product Page Widget

Show Product Page Widget Select ‘Yes’ to display the Product Page Widget on the product detail page
Product Page Widget Logo Four Openpay logo options available to choose from – Grey Logo with Amber Background, Grey, Amber or White

Cart Widget

Show Cart Widget Select ‘Yes’ to display Cart Widget on the cart page
Cart Page Widget Logo Two Openpay logo options available to choose from – Grey Logo with Amber Background or Grey

Checkout Page Widget

Show Checkout Page Widget Select ‘Yes’ to display Checkout Page Widget for the checkout page of the website
Instalment Text For Australia add text: Pay in interest free fortnightly instalments.
As per the instalment plan set on your Openpay account.
(Leave this field blank for the United Kingdom)
Redirect Text Add text: You will be redirected to Openpay’s website to complete your order when you click “Proceed to Openpay”.

Openpay Widget CSS

Widget Custom CSS Use this box to add extra CSS for special placement or alignment of the widget or to change the fonts, size and colours
Click ‘Save Config’


The next step is to add the assets, Landing Page, Quick Links, Trust Logo, and Banners.

Openpay Landing Page Setup

For Openpay Landing Page create a blank page.

Navigate to > Content > Element > Pages > Add New Pages > name the page “Openpay”

Select > Landing Page > Openpay from the pre-populated pages under the General configuration as shown above > Save Config

Openpay Landing Page

Trust Seal

Add the Openpay trust seal under the “Available Payment Methods” section on the footer.

Download the trust seal from here.

Example of how Openpay Landing Page, Quick Link and Trust Seal will be showcased.

Assets - Landing Page, Quick Link and Trust Seal

Banners / Style Guide

The entire suite of digital banners can be found here.

Frontend View of Openpay Widgets

If the module is enabled from the admin with the correct setting the widgets will be displayed as follows on the different sections of the website.

Info Belt Widget

Displayed on top of the homepage above the navigation.

Info Belt Widget


Catalog Page Widget

Displayed on Product Listing/Catalog Page.

Product Catalog / Listing Page


Product Page Widget

Displayed on Product Detail Page.

Product Page Widget


Cart Page Widget

Displayed on Cart Page.

Cart Page Widget


Checkout Page Widget

Displayed on Checkout Page.

M2 Checkout Page Widget


Learn More – Popup

All ‘Learn more’ links will open a popup as follows indicating the available repayment months and explaining what you need to get started to use Openpay.

Learn More - Pop up

Demo Site

Shows the placement of all the Openpay widgets and assets.


In order to disable the extension, run the following command.

php bin/magento module:disable Openpay_Widgets

composer remove opy/widgets
  • php bin/magento setup:upgrade
  • php bin/magento setup:static-content:deploy -f
  • php bin/magento cache:flush


Version Control Table

# Date Version Description
1 Febuary 2021
Created new all in one widget