Transaction Status
The status of a transaction represents its current state in the payment process. Below is the list of possible transaction statuses:
| Status | Description |
|---|---|
| NEW | New transaction, waiting to be processed. |
| SUCCEED | The transaction was completed successfully. |
| PENDING | The transaction is pending and awaiting processing by the Payment Service Provider (PSP). |
| FAILED | The transaction failed. |
| CUSTOMER_VERIFICATION | Customer interaction is required (e.g., 3D Secure authentication). |
| REFUNDED | The transaction was partially or fully refunded. |
| CHARGED_BACK | The transaction was charged back by the customer. |
| PROCESSING | The transaction is being processed. |
Error Handling
When interacting with the API, it’s essential to handle responses appropriately to ensure seamless integration and a smooth user experience. Below are the possible response codes and their meanings:
| HTTP Status Code | Description |
|---|---|
| 200 OK | The transaction request was successful, and the response contains the transaction details. |
| 400 Bad Request | The request contains invalid or missing parameters. The response will indicate specific issues. |
| 401 Unauthorized | The request may contain invalid credentials or is missing the Bearer token in the HTTP headers. |
| 403 Forbidden | The Merchant doesn’t have permissions to access this API resource. |
| 404 Not Found | The requested entity was not found in the service. |