Payment statuses and result codes
When the payment is being performed, it changes its statuses depending on different events occuring during its processing. It is necessary to consider the status of your payment as it may require some actions from you for the payment to be completed.
You can learn the status of your payment:
- by using the PagaSul Dashboard which is available at https://merchant.pagasul.com. Contact your key account manager at PagaSul to get access there
- by checking responses and callbacks the payment platform sends to your system
- by sending a request for the payment status to the PagaSul payment platform. To learn how to create such a request, see Payment status in the API Reference
Payment statuses
The following table contains the information about the payment statuses occuring when performing payments in the Pagasul payment platform and the actions that you may need to perform upon these statuses.
| Status | Description | Is final | Action needed |
|---|---|---|---|
| new | This is first status upon registration payment in our system. Payment is enqueued for processing | No | No |
| redirect | To continue payment process customer redirection required | No | Redirect customer to CheckoutUrl Redirect customer to redirect_data.url (strict H2H flow) |
| processing | Payment is processing | No | No |
| pay pending | Payment data for instruction provided. (strict H2H only) | No | Display instruction to customer with params provided in payment_data section |
| pay confirm | Payment is awaiting confirmation | No | No |
| success | Final positive payment status. Payment was completed and balance is fulfilled | Yes | No |
| decline | Final negative payment status | Yes | No |
| failed | Payment processing encountered an error, manual intervention required | No | Contact with PagaSul customer support to resolve payment status |
To query payment status via the API, see Payment status in the API Reference.
Result codes
The following table contains the information about the request processing result codes you receive in responses and callbacks from PagaSul, as well as their messages, description, and the actions that you may need to perform upon these result codes.
| Result Code | Message | Description | Required action |
|---|---|---|---|
| OK | — | The request is processed successfully. This result code does not mean that the payment is completed successfuly. It signifies that the payment platform accepted your request and started processing the payment | The required action depends on the status of the payment, e.g., if the payment is assigned the success status, no action is required. If it is in the redirect status, redirect the customer to the URL you've been provided with |
| BAD REQUEST | invalid request format | The request is malformed | Contact the technical support |
| invalid signature | Invalid signature was sent in the request | Correct the signature and resend the request | |
| validation failed | Received data cannot be validated | Contact the technical support | |
| unauthorized | Authorization failed, e.g. due to an incorrect account ID passed in the request | Correct and resend the request or just resend the request | |
| NOT FOUND | payment not found | Payment is not found in the system | Resend the request or contact the technical support |
| NOT CREATED | internal error | An internal error has occurred in the system | Contact the technical support |