422 — Validation Errors - Dollr Developer Docs

422 Unprocessable Entity means JSON was understood but one or more fields failed validation.

The problem

The response includes a detail array:

{
  "detail": [
    {
      "loc": ["body", "currency"],
      "msg": "field required",
      "type": "value_error.missing"
    }
  ]
}

Each item points to a field (loc) and message (msg).

`loc` / pattern	Fix
`body.currency`	ISO 4217 uppercase, e.g. `USD`, `LRD`
`body.phone`	E.164 digits only, no `+` (e.g. `231771234567`)
`body.reference_id`	UUID v4 — see duplicate reference_id
`body.method` / `body.provider`	Use MMO prediction or payments by market
`body.counterparty_id`	Create counterparty first in document-first flows
`body.source_type` / `source_kind`	Use `INVOICE` or `ORDER` — see Checkouts

Log the full detail array

Do not only read HTTP status — every loc entry is a required fix.

Compare with API Reference

Open the matching operation under API Reference and align required fields.

Re-test with minimal payload

Strip optional fields until the call succeeds, then add fields back.

Last modified on May 22, 2026