Integration Options

You can integrate POLi in one of the following ways:

  • Installing a plugin or extension into your E-commerce platform
  • Mobile App
  • Embedded Integration

Plugins are available for your E-commerce platform

Our shopping cart plugins make it incredibly simple to integrate POLi into your E-commerce website. Almost no technical knowledge is needed.

Firstly, you need to make sure you have signed up for your POLi account – Sign up here.

Simply select which ecommerce platform you wish do integrate POLi into and complete the sign up process.

Please note, POLi is available on the following platforms:

  • Shopify
  • WooCommerce
  • Wix
  • OpenCart
  • Magento
  • Prestashop
  • Gravity Forms
  • CS Cart


We also have integrations available with a variety of other software systems. For a full list of integration options visit our Software Integrations page.

Once you have completed your online signup, we will send you an email with instructions on how to configure your chosen option for your E-commerce website.

Mobile App Integration

Integrating POLi with a mobile application is nearly identical to any other form of integration, except for one key point.

{danger} Important:
We strongly suggest that a middle-ware web-service be developed by the merchant to facilitate POLi as a payment service via their application.

mobileapp

{warning} Caution:
This application integration approach will not compromise the basic authentication in place.

Embedded integration

Opening POLi as an embedded option is considered an effective strategy to keeping customers on your site.

This section demonstrates the options available to you and will help you to implement them properly, mitigating some of the common issues encountered.

{danger} Important:
All embedded options require you (the merchant) to have your own SSL certificate for security reasons.

iFrame

To open POLi in an iFrame, there are a few rules that need to be observed to preserve a good user experience.

The iFrame should initially open a page on your domain which initiates a transaction before redirecting the user to POLi.
Scrollbars need to be kept to a minimum.

Below is example code for embedding an iFrame into your site:

<div id="outerdiv" style="margin: 0 auto; width: 900px; padding: 0; max-width: 900px; height: 600px; max-height: 600px; border: 1px solid #f00; overflow: hidden; -webkit-overflow-scrolling: touch;">
    <iframe src="{https://www.google.com}" frameborder="0" style="height:100%;width:100%;margin:0;padding:0;"></iframe>
</div>

iframesample

Due to client interact with the third-party content provider as a first-party website, end user needs to enable both first and third party cookies in client's browser.

SafariConfigSample ChromeConfigSample IOSSafariConfigSample

Overlays

The Overlay method is mostly just an iFrame with different CSS styling. The same rules must be observed: minimise scrollbars and redirect to POLi from your domain.

Below is example code for launching POLi in an Overlay:

<div style="width: 100%; background-color: #000; height: 100%; opacity: 0.4; position: absolute; top: 0px; z-index: 100;"></div>
<div id="iframeContainer" style="display: inline-block; margin: 20px auto 100px; padding: 0px; width: 75%; max-width: 75%; height: 50%; min-height: 500px; max-height: 50%; overflow: hidden;position: fixed;right: 12%;top: 20%;z-index: 105;">
    <iframe src="initiate.php" style="height:inherit;width:100%;margin:0;padding:0;min-height: 500px;" name="poliframe" id="poliframe"></iframe>
</div>

overlaysample