The POLi Nudge
The POLi nudge ensures that the merchant receives a real-time notification that a transaction has reached a terminal state.
If a customer closes their web browser before returning to the merchant's website but after completing the payment, this is how their transaction gets credited and is how the merchant's system is updated.
POLi API Workflow
How do I implement the nudge?
Merchants can specify that the POLi nudge be sent to them by specifying a notification URL in their Initiate transaction request.
POLi will send a HTTP POST to the merchant’s specified Notification URL upon the transaction reaching a terminal state. The data contains the token which is URL-encoded and is posted inside the Request.Form collection in a field marked as Token. The Notification URL must be publicly accessible.
The merchant can then call the GETTransaction API with the token to check the status of the transaction, and update the transaction to credited.
The transaction process ends with one of the following terminal statuses:
|Completed||A successful payment, indicating funds are to be credited to the merchant|
|TimedOut||The customer did not complete the payment in the allotted time|
|Failed||The customer was unable to complete the transaction|
|ReceiptUnverified||POLi is unable to determine if the transaction was successful|
|Cancelled||The transaction was cancelled by the user|
#### << Headers >> #### Connection: Keep-Alive Expect: 100-continue Host: your.url.com Content-Length: 40 Content-Type: application/x-www-form-urlencoded #### << Content >> #### Token=EIgVQw2%2bvHofiynsAW41X5r4AhqbfpL2