Error codes

IDEMPOTENCY_KEY_REQUIRED

HTTP 400No

Legacy-only: older gateways required Idempotency-Key on some writes; current public APIs do not.

By default a failed call returns a result with an error instead of throwing, so your business flow is never interrupted.

Published error codes are permanent: their meaning never silently changes, and deprecated codes keep returning for at least 12 months.

Catalog