NowgateDocs

validation_failed

The request is well-formed JSON, but some values are not acceptable.

On this page

HTTP status: 422 Unprocessable Entity. Retrying the same request unchanged fails the same way.

Why it happens

  • A field has the wrong type, such as a number where a string is expected.
  • A value breaks a limit, such as an order_id longer than 255 characters or expires_in outside 900 to 86,400 seconds.

What to do

Fix the fields listed in errors; each has a JSON pointer, a code and a detail.

Example

The response is application/problem+json. Branch on code, never on title or detail. See errors for the format.

{
  "type": "https://docs.nowgate.io/errors/validation_failed",
  "title": "Unprocessable Entity",
  "status": 422,
  "detail": "What exactly was wrong, in a sentence.",
  "instance": "/v1/payments",
  "code": "validation_failed",
  "request_id": "req_01jc3xb1n6f0q2w8e4r7t5y9v3"
}