Skip to main content

Error Handling

Understand how the API communicates errors using standard HTTP status codes and how your integration should handle authentication issues, invalid requests, and server errors.

Updated over a month ago

The ValPay API uses standard HTTP status codes.

Code

Meaning

200

Request successful

400

Invalid request

401

Authentication failed

404

Resource not found

500

Internal server error

Example error response:

{
"success": false,
"code": "INVALID_API_KEY",
"statusCode": 401,
"name": "q",
"timestamp": "2026-03-10T09:05:59.958Z",
"message": "Invalid API Key",
"traceId": "f5d6d685-7ae4-491e-9300-3f4de818942b"
}

Applications integrating with the API should properly handle error responses.

Did this answer your question?