These states provide a comprehensive overview of the different stages a transaction may go through, allowing for better tracking, management, and resolution of any issues that may arise during the process.
| State | Final TX State | Explanation |
|---|---|---|
| COMPLETED | yes | The transaction has been successfully processed. |
| DECLINED | yes | The transaction has been rejected, often due to issues such as insufficient funds, security concerns, or other reasons preventing successful processing. |
| CANCELLED | yes | The user or system has intentionally terminated the transaction before its completion or transaction got cancelled automatically due to timeout. |
| CHARGEBACK | yes | The transaction was marked as a chargeback, this process typically involves several states or stages, which may vary depending on the payment processor or bank. |
| ERROR | yes | The transaction has encountered an error during processing, and further action or investigation is required to resolve the issue. |
| CHECKOUT | no | The transaction is in progress as the user is currently in the process of finalizing the payment or action. |
| RECONCILIATION | no | The transaction is under review or reconciliation, usually involving checkState request. |
| PENDING | no | The transaction is awaiting further processing or approval. It is in a temporary state and has not been completed or declined. |
| AWAITING_WEBHOOK | no | The transaction is waiting for a webhook notification. |
| AWAITING_REDIRECT | no | The transaction is waiting for a redirect action, typically in scenarios involving online payments where users may need to be redirected to another page for additional information. |
| AWAITING_APPROVAL | no | The transaction is pending approval, often in scenarios where additional authorization is required before completing the WITHDRAWAL transaction. |
| AWAITING_RETURN | no | The transaction is awaiting a customer return from the external API interface. |
| CASCADING_CONFIRMATION | no | The transaction is undergoing customer approval for next provider within cascading list. |
| PARTIAL_COMPLETE | no | The transaction has been successfully initiated by the customer, but currently awaiting for a final confirmation from the acquiring bank. Funds were deducted from the customer’s bank account, but not credited yet. |