API

API errors

Error shapes vary by endpoint. Prefer HTTP status + machine-readable fields when present.

Typical HTTP statuses

Status	Meaning
200	Success
202	Accepted / processing (native Apple Pay)
400	Validation or business rule error
401	Missing or invalid credentials
403	Not allowed for this profile
404	Resource not found
409	Idempotency conflict (native Apple Pay)
500	Server error

{
  "error": {
    "code": "session_expired",
    "message": "...",
    "request_id": "..."
  }
}

Map SDK VenPaysError.code values in the app — see the iOS guide.