Errors

Error responses of the TrezorPay API and what they mean.

Errors answer HTTP 400 (or 404) with:

{ "status": "error", "error": "You must provide a valid address" }
MessageCause
You must provide a valid address and a callbackaddress or callback is missing
Callback URL malformed, please provide a valid URLcallback is not an http(s) URL
You must provide a valid addressaddress is not a valid wallet for this coin
Maximum 20 output addressesThe split has more than 20 outputs
Non multi_token address already created for another tokenThe 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 supportedUnknown currency in a conversion
You must provide a valid valueMissing or non-positive value in a conversion
Your request couldn't be processed, please try again laterA temporary problem on our side; retry

Fees

TrezorPay charges 1.25% per forwarded payment, down to 0.25% with volume. Network costs are passed on at cost.

Build with AI

Integrate TrezorPay with an AI coding agent. One prompt.md covers every endpoint, the callback signature, errors, idempotency and a ready-made test suite.