Skip to main content
You can test your integration against these error codes.

​
Authorisation

Error codeDescriptionSolution
401 - UnauthorizedThe 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 codeDescriptionSolution
Currency is incorrectThis payout currency is currently not supported for payouts.Use EUR.
Payout already existsA payout with this requestId has already been created.Send the request with a unique requestId.
Invalid IBAN formatThe IBAN does not match the required format.Check the IBAN and submit it in a valid format.
Invalid IBANThe 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 nameThe beneficiary name must include both a first name and a last name.Enter the beneficiary’s full name.
Amount must be positiveThe payout amount is zero or below zero.Enter an amount greater than zero.
Amount must have at most 2 decimal placesThe payout amount has more than two decimal places.Enter an amount with no more than two decimal places.
Requested amount exceeds limitThe payout amount exceeds the maximum allowed limit of 9000 EUR.Enter an amount of 9000 EUR or less.
Not enough balanceYour payout balance is too low to complete this payout.Top up your payout balance or enter a lower amount.
Error codeDescriptionSolution
PaymentId is requiredThe PaymentId parameter in your request is empty.Resend the request with a PaymentId included.
PaymentId has incorrect formatThe PaymentId parameter in your request does not match the required format.The PaymentId should match this regex format: ^[0-9a-zA-Z._-]+$.
Amount is requiredThe 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.TheexpiryDate 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.TheexpiryDate should be a point in the future.Resend the request with a valid expiryDate.
Last modified on May 25, 2026