Page footer

{  "schema": "docara.page.v1",  "title": "API error codes",  "description": "Demo page with a footer of text and a link.",  "layout": {    "regions": {      "footer": {        "enabled": true,        "sections": [          {            "id": "site-footer",            "section": "docara.shell",            "utilities": ["flex", "flex-col", "gap-1"],            "blocks": [              {                "id": "copyright",                "block": "shell.element",                "slot": "content",                "element": {"tag": "p", "text": "© 2026 Acme Pay. Support is available 24/7.", "utilities": ["m-0"]}              },              {                "id": "status",                "block": "shell.element",                "slot": "content",                "element": {"tag": "a", "text": "Quick start", "href": "/en/demonstrator-results/preset-docs/", "aria_label": "Open the Acme Pay quick start"}              }            ]          }        ]      }    }  },  "navigation": {"order": 80}}

---
noindex: true
---

# API error codes

If a request fails, the API responds with an HTTP code and an `error` object
with a machine-readable code and a message.

| Code | HTTP | What to do |
|---|---|---|
| `invalid_amount` | 400 | Pass the amount as a string with two digits after the point |
| `invalid_key` | 401 | Check the key and the mode: test or live |
| `payment_not_found` | 404 | Check the payment ID |
| `rate_limited` | 429 | Retry after the time in the `Retry-After` header |