Statuses
Payment Statuses
The table below lists the payment statuses that are used in the Get Payment Status API and Payment Notifications.
| Status | Description | Status API Response | Notifications (Webhook) |
|---|---|---|---|
| AWAITING_AUTHORISATION | Payment Session was created by the merchant. The shopper is going through the Waave Pay by Bank screens, and has not approved the payment yet. | X | |
| SHOPPER_SCANNED | (Relevant for QR code payments only) Payment QR code was scanned by the shopper. The shopper is going through the Waave Pay by Bank screens, and has not approved the payment yet. | X | |
| ACCEPTED | A transient status that indicates the payment was approved by the shopper but Waave is yet to authorise it. At this point, the fund is not guaranteed, and the merchant should not fulfil the order. | X | |
| INSTRUCTION_SENT | Payment was approved by the shopper and authorised by Waave. When this status is returned, the fund is guaranteed and the merchant can fulfil the order. | X | X |
| CANCELLED | Payment Session was cancelled by the shopper or merchant, and can no longer be used for payment. | X | X |
| EXPIRED | Payment Session has expired and can no longer be used for payment. | X | |
| DECLINED | Payment Session was declined by Waave for fraud or other reasons, and can no longer be used for payment. | X | X |
| ERROR | A technical error was encountered. The Payment Session can no longer be used for payment. | X | X |
Refund Statuses
The table below lists the refund statuses that are used in the Get Refund Status API and Refund Notifications.
| Status | Description | Refund Status API | Notifications (Webhook) |
|---|---|---|---|
| ACCEPTED | Refund request was accepted by Waave. Waave will process the refund within 2 - 3 business days. | X | X |
| COMPLETE | The fund was successfully returned to the shopper. | X | |
| FAILED | The found could not be returned to the shopper due to issues with the banks or bank account details. | X | X |
Updated 5 months ago