Payment statuses
The lifecycle of a transaction
Every transaction in the system has a status that indicates its progress.
Status definitions
| Status | Description |
|---|---|
| Pending | The payment process has started but hasn't completed. The customer might be on the checkout page or the bank is processing the request. |
| Captured | The payment was successful. The money has been received by the system for your agency. |
| Failed | The payment attempt was rejected by the bank or payment processor (e.g., insufficient funds, invalid card). |
| Refunded | The transaction has been reversed, and the money has been returned to the client. |
| Voided | An authorized transaction was cancelled before the money was actually captured. |
The payment flow
Initiation
A client starts the checkout process -> Status: Pending.
Processing
The payment gateway (Paymob) attempts to charge the card.
Outcome
- If successful -> Status: Captured.
- If declined -> Status: Failed.
Post-payment
If the reservation is cancelled later -> Status: Refunded.