Errors
Every error has the same shape:
{ "error": { "type": "invalid_request_error", "code": "parameter_invalid", "message": "display_name: Too small", "param": "display_name", "request_id": "req_...", "doc_url": "https://docs.rivecard.com/errors/#parameter_invalid" } }| type | HTTP | meaning |
|---|---|---|
invalid_request_error |
400 | bad parameters (parameter_invalid, cursor_invalid, controls_invalid, …) |
authentication_error |
401 | missing/invalid credential (api_key_invalid, token_invalid, code_invalid, …) |
permission_error |
403 | role too low, csrf_token_invalid, origin_not_allowed, live_mode_disabled |
not_found_error |
404 | resource_missing, route_not_found |
conflict_error |
409 | card_closed, idempotency_in_progress, member_exists |
idempotency_error |
422 | idempotency_key_reused — same key, different request |
rate_limit_error |
429 | rate_limited — honour Retry-After |
issuer_error |
502/503 | not_configured — the issuer isn’t set up yet |
api_error |
500 | our fault; send us the request_id |