Error codes - Rocka

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. 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`.

Last modified on May 25, 2026

⌘I