How to offer POLi to your customers


Sign up for a POLi account

Get your Merchant Code and Authentication Code after signing up

Integrate

Integrate POLi into your website checkout or create POLi links

Go Live

We have you complete a QA test prior to settings your account live


{info} Note: For more information on the POLi Console, please refer to POLi Console.

Basic Authentication

What is Basic Authentication?

Basic authentication is a means of uniquely and securely identifying the POLi merchant by the use of a Merchant code / Authentication code pair.

Basic Authentication is an HTTP standard. Please see: Basic Authentication RFC.

Is it Secure?

The BA mechanism provides no confidentiality protection for the transmitted credentials. They are merely encoded with Base64 in transit, but not encrypted or hashed in any way. Basic Authentication must therefore be used over HTTPS.

HTTPS is a secure communication protocol used to ensure the confidentiality and integrity of data exchanged between a user's web browser and the web server.

How do I use it?

To use Basic Authentication with POLi, you need to format a string like so:
MerchantCode:AuthenticationCode

Then Base64 encode it:
TWVyY2hhbnRDb2RlOkF1dGhlbnRpY2F0aW9uQ29kZQ==

And set it as the 'Authorization' header, with the word 'Basic' in-front of it:
Authorization: Basic TWVyY2hhbnRDb2RlOkF1dGhlbnRpY2F0aW9uQ29kZQ==

Now, you'll automatically authenticate against our API whenever you make a request.

{warning} Caution: Be sure to include this header whenever communicating to our POLi API.