Use this endpoint to check on the status of a payment request by providing the requestId of a previously generated payment.
Get the status of a payment request
In order to check on the status of a payment request and confirm it has been completed, you are able to re-call the /PaymentRequests endpoint - but rather than submitting the creation of a new request, you will use GET to retrieve the status of a previously created request.
Please note that you will have to use the /Authorize endpoint to authenticate and generate an access_token before calling this endpoint. If implemented, it is recommended that you are able to poll this endpoint every 30 seconds until you receive an update in the status field. However, it is highly recommended to use Events as detailed in the quick start guide in order to provide the user the best experience on the front-end.
Once authenticated, you can provide the previously generated requestId of a payment transaction to receive an update on the current status of the given transaction. The API will return with this status (see below for currently supported statuses) as well as the ReferenceId provided upon generation of a session. Finally it also includes the original PaymentLink that was generated for the given transaction, this can be used to represent the link to the user if it is still in an 'initiated' state.
Payment Status
Please find all currently available statuses and descriptions below.
| Status | Description |
|---|---|
| Initiated | Request for Payment has been received and ready for processing by the end-user. |
| Processing | User is processing the transaction and transaction is ready to be fulfilled. |
| Accepted | User has accepted the payment request at their Financial Institution and the funds flow has started. Funds are guaranteed at this stage. |
| Processed | Flinks has processed the transaction and is awaiting settlement to your account. |
| Settled | Payment request successfully completed and fund transfer has been initiated to your account. |
| Cancelled | Payment was cancelled before being initiated. |
| Expired | End user did not action the payment request and the request has expired. You will need to initiate a new request if necessary. |
| Declined | End user has declined the payment request at their Financial Institution. |
| Failed | Payment request has failed. |
| failed_name_matching | Returned in the 'StatusDetails' field. Indicates that the reason for the failure was due to the name submitted during the creation of the session and the name returned from the External FI did not match, and as such the transaction has failed. No funds have been moved, you can create a new session with an adjusted correct name as appropriate. |