1. Introduction

As soon as you start working with our platform, sooner or later it happens: You get stuck. You receive cryptic error messages and our platform rejects your transaction requests. 

But fear not: We have the tools that will help you. We have designed our platform to give you the greatest autonomy in your daily online transaction business, even when confronted with errors.    

Have a look at our best practices, our troubleshooting tools and explanations of the most common error messages. They will help you greatly to prevent and solve transaction trouble! 

2. Follow Best Practices

The best way to tackle down errors is – of course – to avoid them in the first place. Although this is not possible in all cases, we have created a list of best practices. Following them will help go live faster by dodging the most common obstacles: 

  • Always use our Testumgebung first before going live or adding a new feature to your live shop. Both our Testumgebung nav.aside.title.get-started.live-environment treat transaction request in the same way. As the expected behaviour and error messages are the same, it is an ideal way to test for any imponderables or stage scenarios 
  • Read the dedicated guide for the respective product carefully. Make sure to know the correct endpoint URL and all accepted parameters. Start sending requests with the absolute minimum of mandatory parameters to learn the basics of the respective product. This is especially helpful when dealing with alternative payment methods that require a lot of parameters.  
  • Check that the payment method you want to use is activated in your Back Office (Configuration > Payment Methods) and targeted in your request with parameters PM/BRAND 
  • Confirm that the option you want to use is activated in your Back Office (Configuration > Account > Your options) 
  • Distinguish failed requests from unsuccessful payments 
    • failed request is the result of an unsuccessful pre-payment check by our platformIn most cases, impacted transactions do not have any status at all. They often appear in our secure payment page with a generic error message. These are invalid requests containing technical errors that prevent our platform to process the transaction altogether. Our system adds them to our Back Office error logs with more detailed information. Have a look at the most typical ones and how to treat them.

The image shows a typical generic error message on our secure payment page.

An unsuccessful payment is a transaction with either status 0/1/2. This is the result of a technically valid request, albeit rejected by a third party (by the acquirer or issuer)To learn about the rejection reason, look up the transaction in the Back Office (Operations > View transactions). The acquirer ticket and the 8-digit error message in the transaction overview contains more information

The images shows the acquirer ticket and the 8-digit error message in the transaction overview 

However, failures like these can still be caused by an error on our platform in specific situations. Make sure to contact us if your transaction decline rate is above average. 

3. Use troubleshooting tools

Apart from our best practices, we offer you various diagnostic tools. In many cases, they will help you get to the root cause and amend the error completely on your own! 

  • Every error analysis requires you to understand during which step exactly the error occurs. Have a look at this decision tree to learn where you need to fix your transaction flow:

The flow chart shows the different scenarios of erroneous transactions and how to deal with them

If our platform rejects a transaction, we create a log entry in the Back Office of the PSPID the transaction was sent to. Go to Configuration > Error logs to check them. The table provides valuable information to understand what went wrong and what you can do to fix the error

Column Description

Date time 

Timestamp of the request 


Integration mode trigram. Possible values 

STDGehostete Zahlungsseite 


AFU: Batch (advanced) 

THP: FlexCheckout 


Requestor’s IP address 

The IP the request was sent from 


Unique reference of the transaction in our system. Is only created if the mandatory parameters are sent correctly 


Detailed description of the error. Check our list for the most common error messages 

  • We offer pages in our Back Office you can use to simulate different integration modes. Go to Support > Integration and user manuals > Test pagesChoose one of the available modes by clicking on “.asp” in the respective line. In the subsequent screen, fill in the first set of parameters (which are the mandatory parameters for each integration). Click then on “Submit to send the request. 
  • We constantly monitor our platform to react quickly for any unforeseen events that may impact your online business – something you can do, too! Enrol with our status page to be always up to date for outages and planned maintenance. This will help you distinguish problems on our platform from errors on your end. 

The image shows the Ingenico status page displaying a notification about a service interruption for one our acquirers.  

4. Understand error messages

An important part of amending errors is to know exactly what they mean. We have collected the most common ones with some detailed explanation. All these error messages appear either in the 

  • Customers’ browser during the payment process 
  • Back Office (Configuration > Error logs) 
  • XML response you receive for DirectLink / FlexCheckout requests 

Find more errors and how to deal with them in our Transaktionsfehlercodes overview 

All described errors prevent our platform from processing the request altogether.

5. Transaktion Fehlercodes

Weitere Informationen zu Statuszuständen und Fehlercodes finden Sie hier und in Ihrem Worldline Konto. Melden Sie sich einfach an und gehen Sie zu: Support > Integrations & Benutzerhandbücher > Benutzerhandbücher > Liste der Status- und Fehlermeldungen.

Häufig gestellte Fragen

Es gibt verschiedene Gründe, warum die Gutschrift einer Transaktion nicht möglich ist. Sie müssen Folgendes berücksichtigen (vorausgesetzt, die Gutschrift-Option ist in Ihrem Konto aktiviert) :

  • Die Transaktion hat einen „unvollständigen“ Status wie „offen“ oder „fehlerhaft“ (9193 usw.), der eine Rückerstattung nicht zulässt.
  • Wenn die Transaktion autorisiert ist (Status 5) und noch keine Zahlung erfolgt ist, müssen Sie in diesem Fall anstelle einer Gutschrift die Autorisierung stornieren.
  • Das verwendete Zahlungsverfahren unterstützt keine Gutschriften. Dies kann bei einigen Debitkarten, Web-Banking-Verfahren und „Offline“-Zahlungsverfahren wie Banküberweisung der Fall sein.

Die Nachricht „Es ist ein Fehler aufgetreten. Bitte versuchen Sie es später noch einmal. Wenn Sie der Eigentümer oder Integrator dieser Website sind, melden Sie sich bitte im Worldline Backoffice an, um die Details des Fehlers zu sehen.“ ist eine allgemeine Fehlermeldung, die ausgegeben wird, wenn zum Zeitpunkt des Aufrufs der Zahlungsseite ein bestimmtes technisches Problem auftritt. Den tatsächlichen Fehler zeigen wir nicht auf der Zahlungsseite an. Das tun wir vor allem aus Sicherheitsgründen, aber auch, um Ihre Kunden nicht zu verwirren.

In Ihrem Worldline-Konto können Sie unter „Konfiguration“ > „Fehlerprotokolle“ auf einfache Weise nachsehen, welche Fehler beim Anzeigen der allgemeinen Fehlermeldung aufgetreten sind. Die konkrete Bedeutung dieser Fehler ist auf der Seite Mögliche Fehlermeldungen beschrieben.

Manchmal kommt es vor, dass eine Vertragsnummer auf der Seite des Akzeptanzpartners auf inaktiv gesetzt wurde. Wir empfehlen Ihnen, dass Sie sich diesbezüglich an Ihren Akzeptanzpartner wenden.