Error handling
Paynow Payments API uses HTTP status codes together with error objects to communicate errors. When an API call fails, it responds with a 4xx or 5xx HTTP status code together with a response body containing an error object. The object contains the error code and the list of error messages.
Information about possible errors for each request can be found below and the API Reference section.
| Error type | Description |
|---|---|
| AUTHORIZATION_CODE_EXPIRED | Expired BLIK code |
| AUTHORIZATION_CODE_INVALID | Invalid BLIK code |
| AUTHORIZATION_CODE_USED | Already used BLIK code |
| INSUFFICIENT_BALANCE_FUNDS | Not enough funds on the balance to make a refund |
| INSUFFICIENT_CARD_BALANCE_FUNDS | Not enough funds on the card balance to make a refund Only for card payment refunds |
| NOT_FOUND | Can not find the requested value |
| PAYMENT_AMOUNT_TOO_LARGE | The amount of payment is too large |
| PAYMENT_AMOUNT_TOO_SMALL | The amount of payment should be greater than 100 PLN |
| PAYMENT_METHOD_NOT_AVAILABLE | Chosen payment method is not available |
| REFUND_AMOUNT_TOO_LARGE | The amount of refund is too large |
| REFUND_AMOUNT_TOO_SMALL | The amount of refund is too small |
| REFUND_POSSIBILITY_EXPIRED | Payment refund possibility expired because transaction is older than 6 months |
| SYSTEM_TEMPORARILY_UNAVAILABLE | Our system is temporarily unavailable (very rare) |
| UNAUTHORIZED | Payment request was formulated incorrectly |
| VALIDATION_ERROR | Payment request was formulated incorrectly |
| VERIFICATION_FAILED | Your signature header is incorrect |