validation_failed

HTTP 400 · The request body is the wrong shape.

What causes it

A field is missing, the wrong type, or out of range. Also the fallback code for any other 400 or 422 that was not thrown with a more specific code, so a `422` you cannot otherwise explain will carry it.

What to do

Read `errors[]` — one entry per invalid field, with `field` as a dotted path into your body and `message` as the human explanation. The classic first hit is a decimal `amount`: COP has no minor unit, so send `50000` for COP 50.000.

Retry?

No — the same request produces the same answer.

The response

{
  "type": "https://developers.vaki.co/errors/validation_failed",
  "title": "…",
  "status": 400,
  "code": "validation_failed",
  "detail": "…",
  "instance": "/v1/checkout_links"
}

Branch on code, never on title or detail. The full list of codes, and the shape of the problem document, is on Errors.