Skip to main content

Error Codes

This page lists all error codes you may encounter when integrating with Paysera Checkout API. Each error includes a description, detailed explanation, and suggested solutions.

Quick Debug

Most errors are related to incorrect parameters or project settings. Always verify your project credentials and parameter values first.

Common Errors​

Error 0x1 - Payment amount is too small​

Description: The provided amount parameter in the payment request is too small for the specified payment method.

Explanation: Some payment methods only allow payments from a certain minimum amount. The amount you specified doesn't meet the minimum requirement for the selected payment method.

Solutions:

  • Check the amount limits for the specified payment method in Payment Types

Error 0x2 - Payment amount is too big​

Description: The provided amount parameter in the payment request is too big for the specified payment method.

Explanation: Some payment methods only allow payments up to a certain maximum amount. The amount you specified exceeds the maximum limit for the selected payment method.

Solutions:

  • Check the amount limits for the specified payment method in Payment Types

Error 0x3 - Selected currency is not available​

Description: The provided currency parameter in the payment request is not available with the specified payment method.

Explanation: Some payment methods only allow specific currencies. The currency you specified is not supported by the selected payment method.

Solutions:

  • Check if the provided currency parameter is a valid currency code (e.g., EUR, USD, GBP)
  • Contact customer support to find out if the specified currency is allowed with the selected payment method

Error 0x6 - projectId is missing or does not exist​

Description: The projectid parameter in the payment request is not provided or the provided ID does not exist.

Explanation: Either you haven't specified a project ID, or the project ID you provided doesn't match any existing project in the system.

Solutions:

  • Make sure the project ID field in your plugin/platform settings is filled in. If the integration is done via specifications/library, you must set the projectid parameter in the payment request. See Request Parameters
  • Make sure you entered the correct project ID. To find your project ID:
    1. Log in to your Paysera account
    2. Go to Projects and Activities → My projects
    3. Copy your project ID

Error 0x7 - Testing mode is turned off​

Description: The test parameter is set to 1, however test payments are disallowed in the specified project.

Explanation: You're trying to make a test payment, but your project settings don't allow test payments.

Solutions:

  • If you want to make a real payment, disable 'test' mode in your plugin/platform. If the integration is done via specifications/library, set the test parameter to 0
  • If you want to make a test payment, enable test payments in your project:
    1. Log in to your Paysera account
    2. Go to Projects and Activities → My projects → Project settings
    3. Navigate to Payment collection service settings
    4. Enable Allow test payments

Error 0x8 - Payment method banned​

Description: The provided payment method is not available for the specified project.

Explanation: The payment method you're trying to use is either invalid or disabled in your project settings.

Solutions:

  • Make sure the payment parameter in the payment request is valid. See Payment Types
  • Check if the payment method is enabled in your project:
    1. Log in to your Paysera account
    2. Go to Projects and Activities → My projects → Project settings
    3. Navigate to Payment collection service settings
    4. Enable the required payment method

Error 0x9 - Incorrect paytext encoding​

Description: The provided paytext parameter in the payment request is coded incorrectly.

Explanation: The payment description text must be encoded in UTF-8 format.

Solutions:

  • Make sure the paytext parameter is encoded in UTF-8
  • You can omit the paytext parameter, as Paysera offers a default payment description. See Request Parameters

Error 0x10 - Empty or incorrect orderid​

Description: The orderid parameter in the payment request is not provided or is set incorrectly.

Explanation: Every payment request must include a valid order ID, or you need to configure your project to allow duplicate payments.

Solutions:

  • Make sure the orderid parameter is set correctly. See Request Parameters
  • If you don't need the orderid parameter, you can set it to 0. However, you must then allow duplicate payments in your project:
    1. Log in to your Paysera account
    2. Go to Projects and Activities → My projects → Project settings
    3. Navigate to Payment collection service settings
    4. Disable Do not allow to pay twice

Project Status Errors​

Error 0x11x0 - Project not checked​

Description: The project is not checked, but you tried to collect a real payment.

Explanation: Real payments can only be collected in activated projects. Your project hasn't been reviewed yet.

Solutions:

  • If integration is complete, submit your project for review:
    1. Log in to your Paysera account
    2. Go to Projects and Activities → My projects
    3. Click Submit for review
  • If you're still testing, enable test mode in your plugin/platform settings or set the test parameter to 1

Error 0x11x2 - Project suspended​

Description: The project is suspended, but you tried to collect a real payment.

Explanation: Real payments can only be collected in activated projects. Your project is currently suspended.

Solutions:

  • Submit your project for review to activate it:
    1. Log in to your Paysera account
    2. Go to Projects and Activities → My projects
    3. Click Submit for review
  • For testing, enable test mode in your plugin/platform settings or set the test parameter to 1

Error 0x11x4 - Project blocked​

Description: The project is blocked. Payments are not allowed in blocked projects.

Explanation: Your project has been blocked and cannot process any payments.

Solutions:

Error 0x11x5 - Project deleted​

Description: The project is deleted. Payments are not allowed in deleted projects.

Explanation: The project you're trying to use has been deleted from the system.

Solutions:

Error 0x11x6 - Project checked but not confirmed​

Description: The project is not yet confirmed, but you tried to collect a real payment.

Explanation: Real payments can only be collected in activated projects. Your project has been reviewed but not confirmed yet.

Solutions:

  • If you've addressed all comments from the previous review, submit the project again:
    1. Log in to your Paysera account
    2. Go to Projects and Activities → My projects
    3. Click Submit for review
  • For testing, enable test mode in your plugin/platform settings or set the test parameter to 1

Security & Configuration Errors​

Error 0x13 - URL address mismatch​

Description: The accepturl, cancelurl, callbackurl, or referer address differs from the addresses confirmed in the project.

Explanation: For security reasons, all URLs used in payment requests must be confirmed in your project settings. The addresses you're using don't match the confirmed ones. It is enough to provide your website domain, no need to type the exact path to the cart.

Solutions:

  • Confirm website ownership of all addresses you're using:
    1. Log in to your Paysera account
    2. Go to Projects and Activities → My projects → Project settings
    3. Add and verify your website domains
  • Check for typos in the provided addresses. Verify:
    • Protocol: http:// or https://
    • Subdomain: with or without www
    • Use copy+paste instead of typing manually
  • If using a platform, check if it requires additional addresses to be added to your project

Error 0x14 - Invalid signature​

Description: The provided sign parameter in the payment request is generated incorrectly.

Explanation: The signature is used to verify the authenticity of payment requests. An incorrect signature means the request cannot be verified.

Solutions:

  • Verify your project password is correct:
    1. Log in to your Paysera account
    2. Go to Projects and Activities → My projects → Project settings
    3. Navigate to General project settings
    4. Copy your project password (use copy+paste)
  • If integrating via specifications, ensure you complete all steps of request parameter generation correctly. See Custom Integration
  • Check if you're using the latest specifications/library version and update if necessary

Error 0x15x0 - Incorrect URL parameters​

Description: At least one of these parameters is incorrect: cancelurl, accepturl, callbackurl

Explanation: One or more of the URL parameters contain invalid values or incorrect formatting.

Solutions:

  • Validate the provided website addresses:
    • Check the URL syntax
    • Ensure URLs start with http:// or https://
    • Verify you're not using local system paths

Error 0x15x1 - Invalid time_limit​

Description: The time_limit parameter is not valid.

Explanation: The time limit parameter is either in the wrong format or the specified time has already passed.

Solutions:

  • Check the format of the time_limit parameter. See Request Parameters for the correct format
  • Ensure the time provided is in the future and hasn't passed yet
  • Make a new payment request if the defined date has already passed

Recurring Payment Errors​

Error 0x18 - Incorrect periodic payment parameters​

Description: At least one of these parameters is incorrect: periodic_payments_frequency, periodic_payments_start_date, periodic_payments_end_date

Explanation: The recurring payment parameters are either in the wrong format or contain invalid values.

Solutions:

  • Ensure periodic_payments_frequency is within the list of allowed values. See Request Parameters for valid frequency values
  • Verify that periodic_payments_start_date and periodic_payments_end_date are in the correct date format
  • Ensure that periodic_payments_start_date is earlier than periodic_payments_end_date
  • Verify that periodic_payments_start_date hasn't already passed

For more information about integrating Paysera Checkout API:

Need Help?

If you're still experiencing issues after trying the suggested solutions, please contact our support team with the error code and details about your integration.