payload_too_large
The request body is too large.
| HTTP status | type | Retry the same request? |
|---|---|---|
| 413 | invalid_request_error | after a change |
Why it happens
Bodies are limited to 1 MB. A real request is a few hundred bytes, so this is usually oversized metadata.
What to do
Keep metadata small: at most 20 keys, values up to 512 characters.
Example response
{
"error": {
"type": "invalid_request_error",
"code": "payload_too_large",
"message": "A human-readable explanation. Do not parse it.",
"doc_url": "https://docs.skanpay.website/errors/payload_too_large",
"request_id": "req_01J9Z3K8Q4W6XK2M7N5P0R3T8V"
}
}