An IPN error means that the transmission of data by Digistore24 to a target system (email marketing system, CRM or membership system) was not successful.
Important
A failed IPN notification does not usually mean that the purchase and thus the payment was unsuccessful – it just means there were complications with the transmission concerning the payment status/customer information.
If you want to see if an order was successful or not, please look at the transaction details under Reports > Transactions.
In principle, the data is transmitted via IPN through a so-called IPN URL. The IPN URL is a URL that refers to your server (the target system). Digistore24 notifies your server about new sales via the IPN URL.
View the success of your IPN transmission
How to see whether your IPN connection has been successfully transmitted:
- Go to the Vendor view Reports > Integrations (IPN).
- Use the search fields to find the relevant order.
- Click on Search.
- Now you can see the status of your IPN connection.
What to do if there is an IPN error
If there is an IPN error, follow these steps:
- Go to the Vendor view Reports > Integrations (IPN).
- Use the search fields to find the relevant order.
- Click on Search.
- Click on the magnifying glass icon of the relevant transaction.
- Read the text in the Message by server box and follow it. The target server often provides an answer that indicates the solution. For example, it often happens that the Digistore24 product was not correctly set up on the target server or that the target server was not available at the time the IPN signal (IPN call) was transmitted.
- Check if you can open the IPN URL in your web browser.
- If this is not possible, enter the correct IPN URL under Settings > Integrations (IPN). This should solve it.
The most common error sources if you cannot open the IPN URL in your web browser
WordPress security plugins
A WordPress security plugin may prevent Digistore24 from calling the IPN URL. To check this, deactivate all other plugins except your membership plugin (such as DigiMember). If the error persists, you can find out which plugin contains the error by gradually reactivating all plugins and testing whether the IPN notification works.
If the security plugin is responsible for the error, please consult your administrator if you really need the plugin. Make sure that you install all security updates and install WordPress plugins from trusted sources only.
Firewall of the web provider
Some web providers prohibit the program-controlled calling of web pages by other servers. It may be possible to set up a firewall to prevent this.
Again, it is of paramount importance to only install properly programmed software and WordPress plugins from trusted sources on your server. Please contact your web provider so that they enable calls from Digistore24. If necessary, the firewall can also be switched off without security restrictions.
Information for your technician if complications occur
The following note will help your technician to correctly set up your WordPress installation or your web server’s firewall if complications occur:
DigiStore24 sends its own user agent for the HTTP requests in the HTTP header: DigiStore-API/1.0 (Linux; en-US; rv:1.0.0.0) php/20130430 curl/20130430
Sometimes such user agents that do not originate from web browsers are blocked (by security plugins or the firewall).
You can test it with this PHP script:
Save the script as a file with the ending php e.g. test.php
Call it from the command line: php test.php
In the event of an error, the output may be:
HTTP code: 403 (200 is correct – everything else is an error)
Resend IPN notification
To resend an IPN manually:
- Go to the Vendor view Reports > Integrations (IPN).
- Use the search fields to find the relevant order.
- Click on Search.
- Click on the magnifying glass icon of the relevant transaction.
- Scroll down to the window Repeat and click on the button Restart IPN notification.
- If the IPN notification has been sent successfully, a confirmation message will appear.
I no longer want to receive IPN error messages
If the Digistore24 server does not receive success confirmation from the addressed server of the other party during the sale, it assumes that an IPN error has occurred.
In response, Digistore24 tries to send the same IPN notification several times in the hope of receiving a positive response from the other side. In individual cases, this can lead to an annoying error message, also via email.
To turn off IPN error messages:
- Go to the Vendor view Reports > Integrations (IPN).
- Click on the pencil icon of the connection that produces the error message.
- Delete your email address under Email address for notifications of IPN call errors.
-
Click on Save. You will now no longer receive annoying IPN messages.