Error catalog
| code | status | meaning |
|---|---|---|
unknown_parameter | 400 | unknown key in the body (param = the key) |
invalid_request | 400 | invalid/missing field (param when applicable) |
missing_idempotency_key | 400 | Idempotency-Key missing on a creation POST |
invalid_idempotency_key | 400 | malformed Idempotency-Key |
idempotency_key_reuse | 409 | same key, different body |
reserved_metadata_key | 400 | metadata key with a reserved prefix |
merchant_net_not_positive | 400 | absorb link with net ≤ 0 |
not_available_in_live | 403 | sandbox-only endpoint called in production |
invalid_api_key | 401 | nonexistent/revoked key |
insufficient_scope | 403 | key missing the endpoint's scope |
payment_link_not_found | 404 | link not found for the tenant |
payment_not_found | 404 | payment not found for the tenant |
event_not_found | 404 | event not found (the events endpoint is planned) |
internal_error | 500 | unexpected error — cite request_id |
Scopes
payment_links:write · payment_links:read (planned) · payment_intents:read · payment_intents:write · quotes:read · quotes:write · payments:read · payments:write · events:read (planned).
Canonical contract v1. A divergence between the code and this document is a bug in the code; changing this document requires an ADR.