Skip to content

crypto_amount_out_of_range

HTTP 422 · The link’s amount converts to a stablecoin figure outside the asset’s bounds.

What causes it

Every asset carries a floor and a ceiling, in its own units. The floor exists because below it a donation costs more in gas to sweep than it is worth; the ceiling exists because a donation that size deserves a human, and refusing the self-serve path is the honest way to get one. A link for COP 2.000 falls under the floor; one for COP 4.000.000.000 sits over the ceiling. The rail works — this particular link is priced outside it.

What to do

Read `minimum`, `maximum` and `asset` from the error’s extension members: they are in units of the asset, not of the link’s currency. Mint a link inside that band, offer another asset (`GET /v1/checkout_links/{id}/crypto_assets` reports the band per asset), or fall back to card or PSE. For a donation over the ceiling, talk to Vaki.

Retry?

No — the same request produces the same answer.

The response

{
  "type": "https://developers.vaki.co/errors/crypto_amount_out_of_range",
  "title": "…",
  "status": 422,
  "code": "crypto_amount_out_of_range",
  "detail": "…",
  "instance": "/v1/checkout_links"
}

Branch on code, never on title or detail. The full list of codes, and the shape of the problem document, is on Errors.