Integrating POLi Payments


Here you will learn how to:

  • Integrate POLi Payments API services into your system
  • Launch POLi Payments in a mobile App or via embedding HTML elements into your site

Note: If you have not yet signed up for a POLi account, you can do so by clicking here.


Integration Methods


Choose your method of integration

  • WEB SERVICES
    INTEGRATION
  • REST based integration with our POLi API
  • Simple to use, easy to implement, quick to modify, light on bandwidth
  • Invoke POLi by transmitting XML/JSON over HTTP(s), however, we recommend using JSON for better performance
  • Functionalities like redirection after payment, callback after transaction, real-time transaction notification
  • Integrate

  • POLi LINK
    INTEGRATION
  • Easy to implement and lightweight
  • Generates small URL link such as http://poli.to/W3tsQ
  • As a merchant, it is an excellent solution to send someone a bill or an email requesting a payment
  • As a recipient, they simply click the POLi link that takes through POLi transaction page, enter the required details and you get paid!
  • Integrate


Integration Options


You can integrate POLi in one of the following ways:

  • Installing a plugin 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 – please visit POLi online signup

In step 1, please choose the shopping cart from the pick list – if your shopping cart is not listed then we do not offer a plugin for your site. Please also specify the version number of the shopping cart software your site is running.

Please note, we offer the following E-commerce plugins:

  • Shopify
  • WooCommerce 2.6 and above
  • OpenCart 2.0 and above
  • Magento 1.9 and above
  • Prestashop 1.6 and above

Once you have completed your online signup, we will send you an email with a link to download the best POLi plugin for your E-commerce website.

Please note, if you specify Shopify in your online signup, we will send you an email after you have completed your online signup with credentials and instructions to add POLi to your site.


Mobile App Integration


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

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.

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.

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="http://google.com" frameborder="0" style="height:100%;width:100%;margin:0;padding:0;"></iframe>
</div>

Overlay

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>