POLi™ Transaction Status

POLi™ transaction status records the progress of a transaction throughout the payment process. Each status represents a critical point in the transaction and each has to be reached before the customer can progress to the next and ultimately complete the transaction. Broadly speaking, there are two categories of transaction statuses:

Active Attained during the course of a transaction before reaching a terminal status. A transaction with an active state is not considered finished.
Terminal Attained when the transaction has reached a conclusion either successfully or unsuccessfully.
Status Category Description
Initiated Active When a transaction is started, it is immediately assigned the status Initiated
FinancialInstitution Selected Active A transaction moves into the FinancialInstitutionSelected status when the user has selected the Financial Institution that they wish to use.
EULAAccepted Active When the user accepts the POLi™ End User License Agreement, the transaction moves into EULAAccepted
InProcess Active This status is reached when the customer hits the login page of the bank they have selected.
Unknown Active The transaction goes into Unknown status when the user clicks on the Confirm button to make their payment. The result of the payment is pending.
ReceiptUnverified Terminal A rare state attained when POLi™ cannot confirm whether the customer’s payment has been successful or not. In this case, the funds may have been transferred but the customer will not be displayed a receipt from POLi™ or the merchant.
Completed Terminal A successful transaction where the funds have been transferred and POLi™ has recognised the confirmation.
Incompatible Terminal This is a sub-status of 'Failed' and will appear as such from API calls. An unsuccessful transaction which ended because the customer used an unsupported operating system or browser
Rejected Terminal This is a sub-status of 'Failed' and will appear as such from API calls. POLi has rejected this transaction attempt
Failed Terminal A transaction can go into Failed status when an error occurs during the course of the transaction. For example, the customer has an unsupported system, a connection dropout, a communication error or a similar unrecoverable problem.
Cancelled Terminal When the user cancels the transaction it will move into Cancelled status.
TimedOut Terminal Automatically attained when the customer has not completed the transaction before the POLi™ timeout and the transaction is not currently in Unknown.

Transactions with a Completed status typically result in a credit to the merchant’s bank account. Transactions in Failed, Cancelled and TimedOut statuses typically will not result in a bank account credit. The status ReceiptUnverified indicates that there is uncertainty whether the purchasing customer’s bank has processed the payment instruction, e.g. because communications were lost at a critical time. All other statuses indicate that the transaction is still ongoing.

transactionstatus.txt · Last modified: 2017/10/24 10:03 (external edit)