Error Codes
Understand the error responses returned by the API.
Standard Errors
- •UNAUTHORIZED (401): Missing or invalid API key.
- •FORBIDDEN (403): You do not have permission for this resource.
- •NOT_FOUND (404): The requested resource does not exist.
- •VALIDATION_ERROR (422): Your request parameters are invalid.
- •SANDBOX_ONLY (403): This action can only be performed in sandbox.
Payout-specific Errors
- •insufficient balance (422): Your wallet doesn't have enough funds to cover the payout + fee.
- •duplicate idempotency key (409): A payout with this idempotency_key already exists — check its status instead of retrying with a new key.
- •amount exceeds maximum (400): The payout amount is above your account's configured maximum.