> ## Documentation Index
> Fetch the complete documentation index at: https://docs.rocka.live/llms.txt
> Use this file to discover all available pages before exploring further.
# Error codes
You can test your integration against these error codes.
## Authorisation
| Error code | Description | Solution |
| ------------------ | --------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| 401 - Unauthorized | The API key you entered couldn't be verified. | Use a valid API key. To find your API key, go to the Integration tab of your [Rocka Hub](https://hub.rocka.live).
For API requests to `api.stage.rocka.live` (including through the playground on this docs site), use your sandbox key. For API requests to `api.rocka.live`, use your production API key. |
## Payouts
| Error code | Description | Solution |
| --------------------------------------------------------------------------- | -------------------------------------------------------------------- | ----------------------------------------------------- |
| `Currency is incorrect` | This payout currency is currently not supported for payouts. | Use `EUR`. |
| `Payout already exists` | A payout with this `requestId` has already been created. | Send the request with a unique `requestId`. |
| `Invalid IBAN format` | The IBAN does not match the required format. | Check the IBAN and submit it in a valid format. |
| `Invalid IBAN` | The IBAN is valid in format but couldn't be verified. | Use a valid, existing IBAN. |
| `Beneficiary name is invalid, name should contain first name and last name` | The beneficiary name must include both a first name and a last name. | Enter the beneficiary’s full name. |
| `Amount must be positive` | The payout amount is zero or below zero. | Enter an amount greater than zero. |
| `Amount must have at most 2 decimal places` | The payout amount has more than two decimal places. | Enter an amount with no more than two decimal places. |
| `Requested amount exceeds limit` | The payout amount exceeds the maximum allowed limit of 9000 EUR. | Enter an amount of 9000 EUR or less. |
| `Not enough balance` | Your payout balance is too low to complete this payout. | Top up your payout balance or enter a lower amount. |
## Payment links
| Error code | Description | Solution |
| ----------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------- |
| `PaymentId is required` | The `PaymentId` parameter in your request is empty. | Resend the request with a `PaymentId` included. |
| `PaymentId has incorrect format` | The `PaymentId` parameter in your request does not match the required format. | The `PaymentId` should match this regex format: `^[0-9a-zA-Z._-]+$`. |
| `Amount is required` | The `amount` parameter in your request is empty or missing. | Resend the request with the `amount` parameter included. |
| `Amount should be greater than or equal to 0.01.` | The value of the `amount` parameter in your request is too low. | Resend the request with the `amount` parameter set to a value of at least 0.01. |
| `Amount should be less than or equal to 30000.` | The value of the `amount` parameter in your request is too high. | Resend the request with the `amount` parameter set to a value of up to 30000. |
| `Currency is required.` | The `currency` parameter in your request is empty or missing. | Resend the request with the `currency` parameter. |
| `Currency has incorrect value for this merchant.` | The currency you included is not supported by Rocka. | Resend the request with a valid currency (EUR). |
| `Name is required.` | The `name` parameter in your request is empty or missing. | Resend the request with the `name` parameter. |
| `Name length should be less than or equal to 100.` | The value of the `name` parameter in your request is too long. | Resend the request with the `name` parameter set to a string of a length of 100 characters or less. |
| `Payment description is required.` | The `paymentDescription` parameter in your request is empty or missing. | Resend the request with the `paymentDescription` parameter. |
| `Payment description length should be less than or equal to 255.` | The `paymentDescription` in your request is too long. | Resend the request with a valid `paymentDescription`. |
| `ReturnUrl has incorrect format.` | The `returnUrl` parameter in your request does not match the required format. It should be an absolute URL that includes the protocol (http or https). For example, `https://example.com/returlUrl`. | Resend the request with a valid `returnUrl`. |
| `WebhookUrl has incorrect format.` | The `webhookUrl` parameter in your request does not match the required format. It should be an absolute URL that includes the protocol (http or https). For example, `https://example.com/webhookUrl`. | Resend the request with a valid `webhookUrl`. |
| `Expiry date should be in UTC format.` | The`expiryDate` parameter in your request does not match the required format. It should include the date and time in the UTC timezone. For example, `2026-02-27T16:11:51.2863657Z` (with Z for the UTC timezone). | Resend the request with a valid `expiryDate`. |
| `Expiry date should be greater than current date.` | The`expiryDate` should be a point in the future. | Resend the request with a valid `expiryDate`. |