Errors
Error responses of the NoncePay API and what they mean.
Errors answer HTTP 400 (or 404) with:
{ "status": "error", "error": "You must provide a valid address" }| Message | Cause |
|---|---|
You must provide a valid address and a callback | address or callback is missing |
Callback URL malformed, please provide a valid URL | callback is not an http(s) URL |
You must provide a valid address | address is not a valid wallet for this coin |
Maximum 20 output addresses | The split has more than 20 outputs |
Non multi_token address already created for another token | The callback is already used for another coin |
Resource not found (404) | Unknown ticker route |
Callback not found (404) | /logs/ for a callback that never created an address |
Coin not supported | Unknown currency in a conversion |
You must provide a valid value | Missing or non-positive value in a conversion |
Your request couldn't be processed, please try again later | A temporary problem on our side; retry |
You must provide at least one address | /link/create/ without any address_<family> |
Link expired | /link/{link_id}/pay/ on an expired link |
Link unavailable | /link/{link_id}/pay/ on a paid or disabled link |
Value below the coin minimum | The link's amount is below this coin's minimum |
Too many requests (429) | Rate limit reached; retry after Retry-After seconds |
Rate limits
Limits apply per client IP: /create/ allows 120 requests a minute and 20,000 a day, every other route 300 a minute. For payment links, /link/create/ allows 30 a minute and 1,000 a day, /link/{link_id}/pay/ counts against the /create/ limits, and /link/{link_id}/report/ allows 5 an hour. One address per checkout stays far below them. Over a limit the API answers 429 with a Retry-After header giving the seconds to wait.