POLi

Accept POLi payments in your online store.

POLi allows your customers to make payments through direct bank transfer. Use the emerchantpay POLi API to accept POLi as a payment method across all of emerchantpay’s payment integrations.

Payment method	Countries/regions	Supported payments
Bank transfer	Australian, New Zealand	Online banking

Prerequisites

To proceed with this solution, you must have an emerchantpay merchant account. Apply for a merchant account by filling out and submitting this contact form.

You will be assigned an emerchantpay Account Manager, who will provide you with credentials and assist you with any of emerchantpay’s payment solutions.

To integrate with POLi, connect to the emerchantpay Genesis gateway using the emerchantpay POLi API. You should have a working knowledge of web programming languages, HTTP methods in XML and JSON formats, and UTF8 encoding. Use the Genesis SDK libraries with code samples to integrate with the gateway in a range of languages.

For a solution that requires less development overhead, accept POLi payments through the emerchantpay Web Payment Form (WPF). Contact your Account Manager and tell them you want to accept POLi through the WPF, and refer to the WPF API.

1. Create a POLi payment request

To submit a payment using POLi, create a payment request to the emerchantpay Genesis payment gateway. Specify poli as the transaction_type.

POLi transactions are asynchronous, which means that the transaction status will be pending_async while your customer is redirected to POLi for authentication. See the emerchantpay POLi API for the complete list of POLi request parameters and code samples.

Example of passing an POLi payment request:

  <?xml version=”1.0″ encoding=”UTF-8″?>
  <payment_transaction>
    <transaction_type>poli</transaction_type>
    <transaction_id>119643250547501c79d8295</transaction_id>
    <usage>40208 concert tickets</usage>
    <remote_ip>123.456.789.0</remote_ip>
    <notification_url>https://www.example.com/notification</notification_url>
    <return_success_url>http://www.example.com/success</return_success_url>
    <return_failure_url>http://www.example.com/failure</return_failure_url>
    <amount>100</amount>
    <currency>AUD</currency>

Use your staging environment credentials to initially set up and test your integration. Once you are ready to move to production and accept live payments, create a payment request using your production credentials and production URLs.

2. Receive a response

You will receive a Success or Error response to your payment request.

Example of a Success response:

  <?xml version=”1.0″ encoding=”UTF-8″?>
  <payment_response>
    <transaction_type>poli</transaction_type>
    <status>pending_async</status>
    <mode>live</mode>
    <transaction_id>119643250547501c79d8295</transaction_id>
    <unique_id>44177a21403427eb96664a6d7e5d5d48</unique_id>
    <technical_message>Transaction successful!</technical_message>
    <message>Transaction successful!</message>
    <redirect_url>https://staging.gate.emerchantpay.net/redirect/to_acquirer/649e1ff35c61</redirect_url>
    <timestamp>2022-06-29T15:36:39Z</timestamp>
    <descriptor>Descriptor one</descriptor>
    <amount>100</amount>
    <currency>AUD</currency>
    <sent_to_acquirer>true</sent_to_acquirer>
  </payment_response>

Use the returned redirect_url to redirect your customer to authorise the payment with POLi. See the emerchantpay POLi API for the complete list of POLi response parameters and code samples.

Asynchronous notification

Because the POLi payment transaction is asynchronous, the result of your customer’s payment is sent as a separate HTTP POST notification from the gateway to the notification_url that you supplied with the transaction request.

Example of a notification for an POLi transaction:

:transaction_id=>”119643250547501…”,
:terminal_token=>”f6a34b886c07f409a8f6f0899e834b5…”,
:unique_id=>”efc8bf370da577670e2ca65e52…”,
:transaction_type=>”poli”, 
:status=>”approved”, 
:signature=>”8d895b2d231f86ee85cdff64dbfecec1931…”, 
:amount=>10000

The status field provides you with information on the outcome of the transaction. See Transaction States for more information about transaction statuses.

In some cases, POLi will not confirm a successful payment. It is recommended that you display a confirmation message after payment that tells your customer to verify their account balance to avoid repeat charges.

For the full list of notification parameters, see Notifications.

Use the signature field to verify that the notification has been sent by the Genesis gateway. Each session signature is generated by combining the unique_id of the transaction and your API password, and generating a SHA-1 hash function of the combined string.

signature = SHA-1 hash value of <unique_id><API password>

Notification signature examples:

unique_id	API password	signature
26aa150ee68b1b2d6758a0e6c44fce4c	50fd87e65eb415f42fb5af4c9cf497662e00b785	c5219b3d385e74496b2b48a549
3f760162ef57a829011e5e2379b3fa17	50fd87e65eb415f42fb5af4c9cf497662e00b785	14519d0db2f7f8f407efccc9b099

After you have verified the notification state and validity, render an XML page containing the transaction’s unique id to acknowledge that you have received the notification.

Example of a notification reply you use to confirm a notification:

<?xml version=”1.0″ encoding=”UTF-8″?>
<notification_echo>
  <unique_id>3f760162ef57a829011e5e2379b3fa17</unique_id>
</notification_echo>

3. Test your integration

Before you can accept live payments, you must test your integration in the emerchantpay staging environment.

Add an item to your cart in your online store.
Proceed to the checkout page and check out using POLi.
Follow the redirect link to the POLi login.
Follow the POLi Test Account instructions to simulate a payment.
Complete the order and verify that you are redirected to the order confirmation page.
Log in to Genesis.
In the navigation menu, go to Payment transactions.
Verify that the transaction appears at the top of the list and is successful.

4. Accept live payments

After you have successfully tested your POLi integration, you are ready to move to the production environment and accept live payments. Contact your emerchantpay Account Manager to get your login credentials for the Genesis production environment.

To move to the production environment, create payment requests using your production API credentials and production URLs.

You are now ready to accept live payments using POLi.