POLi

Introduction

POLI Logo

POLi is an online payment option that allows consumers to use internet banking to securely pay for goods and services. It allows consumers to pay directly from a merchant’s website without the need of a credit card. POLi Payments is used throughout Australia and New Zealand.

General Information

Payment Mode, Countries and Currencies

This table illustrates which payment mode POLi belongs to. It also provides detailed information about the countries and currencies which are relevant for POLi.

Payment Mode

Online Bank Transfer

Countries

AU, NZ

Currencies

AUD, NZD

Communication Formats

This table illustrates how POLi notifications are encoded and which formats and methods can be used for requests and responses.

Requests/Responses

Format

XML

Methods

POST, GET

IPN Encodement

Please follow the instructions given at Instant Payment Notification to set up IPN.

Transaction Types

For transaction type details which are not given here look at Appendix B: Transaction Types.

Test Credentials

URLs (Endpoint)

https://api-test.wirecard.com/engine/rest/paymentmethods/

Merchant Account ID (MAID)

1e11f676-f3f7-4ca2-ad26-e5fe870f676b

This MAID can only be used to test AUD. NZD cannot be tested at the moment.

Username

16390-testing

Password

3!3013=D3fD8X7

Secret Key

d99e826c-204d-497b-81ec-5ce0a16b1c24

Workflow

POLi Workflow
  1. The consumer selects to pay with POLi on the merchant’s payment page.
    Wirecard Payment Gateway redirects the consumer to POLi to perform the payment.  

  2. The consumer logs into his account on POLi's page.
    Wirecard Payment Gateway redirects the consumer to a payment confirmation page on POLi's page.
    Wirecard Payment Gateway redirects the consumer to the merchant’s page for the final payment status. 

Fields

The fields required for POLi are the same fields as the ReST API Fields.

Samples

For XML we do not list any notification samples. Go to Notification Examples, if you want to see corresponding notification samples.

debit
XML debit Request (Successful)
<?xml version="1.0" encoding="utf-8"?>
<payment xmlns="http://www.elastic-payments.com/schema/payment">
   <payment-methods>
      <payment-method name="poli" />
   </payment-methods>
   <merchant-account-id>1e11f676-f3f7-4ca2-ad26-e5fe870f676b</merchant-account-id>
   <request-id>959ae146-31ae-4eb1-a193-3168fef226b6</request-id>
   <transaction-type>debit</transaction-type>
   <requested-amount currency="AUD">2.00</requested-amount>
   <order-number>181004092031237</order-number>
   <order-detail>Test product 001</order-detail>
   <ip-address>127.0.0.1</ip-address>
   <locale>en</locale>
   <account-holder>
      <first-name>John</first-name>
      <last-name>Doe</last-name>
      <email>john.doe@wirecard.com</email>
   </account-holder>
      <notifications>
         <notification url="add.your.url.here" />
      </notifications>
   <cancel-redirect-url>https://demoshop-test.wirecard.com/demoshop/#/cancel</cancel-redirect-url>
   <success-redirect-url>https://demoshop-test.wirecard.com/demoshop/#/success</success-redirect-url>
   <fail-redirect-url>https://demoshop-test.wirecard.com/demoshop/#/error</fail-redirect-url>
</payment>
XML debit Response (Successful)
<?xml version="1.0" encoding="utf-8" standalone="yes"?>
<payment xmlns="http://www.elastic-payments.com/schema/payment" xmlns:ns2="http://www.elastic-payments.com/schema/epa/transaction">
   <merchant-account-id>1e11f676-f3f7-4ca2-ad26-e5fe870f676b</merchant-account-id>
   <transaction-id>81c766c0-5bfa-4d53-a5b0-0ca9c3ca2200</transaction-id>
   <request-id>959ae146-31ae-4eb1-a193-3168fef226b6</request-id>
   <transaction-type>debit</transaction-type>
   <transaction-state>success</transaction-state>
   <completion-time-stamp>2018-10-04T07:20:32.000Z</completion-time-stamp>
   <statuses>
      <status code="201.0000" description="The resource was successfully created." severity="information" />
   </statuses>
   <requested-amount currency="AUD">2.00</requested-amount>
   <account-holder>
      <first-name>John</first-name>
      <last-name>Doe</last-name>
      <email>john.doe@wirecard.com</email>
   </account-holder>
   <ip-address>127.0.0.1</ip-address>
   <order-number>181004092031237</order-number>
   <order-detail>Test product 001</order-detail>
   <notifications>
      <notification url="add.your.url.here"/>
   </notifications>
   <payment-methods>
      <payment-method url="https://txn.apac.paywithpoli.com/?Token=DtoS%2f57clmvHJiYe0wOlSRPcZwDFjIyv" name="poli" />
   </payment-methods>
   <cancel-redirect-url>https://demoshop-test.wirecard.com/demoshop/#/cancel</cancel-redirect-url>
   <fail-redirect-url>https://demoshop-test.wirecard.com/demoshop/#/error</fail-redirect-url>
   <success-redirect-url>https://demoshop-test.wirecard.com/demoshop/#/success</success-redirect-url>
   <locale>en</locale>
</payment>
XML debit Request (Failure)
<?xml version="1.0" encoding="utf-8"?>
<payment xmlns="http://www.elastic-payments.com/schema/payment">
   <payment-methods>
      <payment-method name="poli" />
   </payment-methods>
   <merchant-account-id>1e11f676-f3f7-4ca2-ad26-e5fe870f676b</merchant-account-id>
   <request-id>0b05d4ed-14bc-46dd-bf80-e7c6624af749</request-id>
   <transaction-type>debit</transaction-type>
   <ip-address>127.0.0.1</ip-address>
   <locale>en</locale>
   <account-holder>
      <first-name>John</first-name>
      <last-name>Doe</last-name>
      <email>john.doe@wirecard.com</email>
   </account-holder>
   <fail-redirect-url>https://demoshop-test.wirecard.com/demoshop/#/error</fail-redirect-url>
   <cancel-redirect-url>https://demoshop-test.wirecard.com/demoshop/#/cancel</cancel-redirect-url>
   <success-redirect-url>https://demoshop-test.wirecard.com/demoshop/#/success</success-redirect-url>
   <notifications><notification url="add.your.url.here" />    </notifications>
</payment>
XML debit Response (Failure)
<?xml version="1.0" encoding="utf-8" standalone="yes"?>
<payment xmlns="http://www.elastic-payments.com/schema/payment" xmlns:ns2="http://www.elastic-payments.com/schema/epa/transaction">
   <merchant-account-id>1e11f676-f3f7-4ca2-ad26-e5fe870f676b</merchant-account-id>
   <request-id>0b05d4ed-14bc-46dd-bf80-e7c6624af749</request-id>
   <transaction-type>debit</transaction-type>
   <transaction-state>failed</transaction-state>
   <statuses>
      <status code="400.1011" description="The Requested Amount has not been provided.  Please check your input and try again." severity="error" />
   </statuses>
   <account-holder>
      <first-name>John</first-name>
      <last-name>Doe</last-name>
      <email>john.doe@wirecard.com</email>
   </account-holder>
   <ip-address>127.0.0.1</ip-address>
   <notifications>
      <notification url="add.your.url.here"></notification>
   </notifications>
   <payment-methods>
      <payment-method name="poli" />
   </payment-methods>
   <cancel-redirect-url>https://demoshop-test.wirecard.com/demoshop/#/cancel</cancel-redirect-url>
   <fail-redirect-url>https://demoshop-test.wirecard.com/demoshop/#/error</fail-redirect-url>
   <success-redirect-url>https://demoshop-test.wirecard.com/demoshop/#/success</success-redirect-url>
   <locale>en</locale>
</payment>
Custom URL: