Quick Integration Guide
This guide is for software developers and system administrators, who want to connect a vendor’s billing system to Digistore24.
Introduction
A buyer orders the product “Guide To Happiness”.
Then there will be:
- An order-ID for each order, e.g. A3NXHEHF. This order-ID is unique.
- A product-ID, e.g. 122343 for product “Guide to Happiness”. Each order of “Guide to Happiness” has the same product-ID 122343.
- A transaction-ID for each transaction and test payment. A transaction is a payment, a refund or a chargeback. This transaction-ID is unique.
Term explanation
Buyer
A buyer is the person in front of the computer screen, who buys your product.
Order
If a buyer buys one or more products using the same order form at the same time, this is one order.
An order consists of one initial sale and up to three upsells. These are referred to as “order items”.
Transaction
A transaction is a payment, a refund or a chargeback.
At Digistore24, we process one transaction for each order item.
Example: If a buyer buys an initial sale and the first upsale, then there are two transactions meaning two payments.
IPN Call
This is the instant payment notification (IPN) we send to your server. For each transaction, there is one IPN-call. If a customer buys three products, there will be three IPN calls – one for each payment of each product.
Quick Integration Guide
Prepare the IPN-script
- Download the IPN-receiver script here.
- Review the script. Locate the comments and adjust the script according to the comments. Pay special attention to the “// EDIT HERE”-comments.
- Make sure the constant SHA_PASSPHRASE is set to a unique, non-guessable value.
- Put the script on your server. Note the URL, which will run the script on your server.
Create a IPN-connection in Digistore24
- Go to Settings > Integrations (IPN).
- Click on “Add new connection”.
- Scroll down and click on “Generic”.
- Select the checkboxes for all products you want to handle by the IPN-script. Or just select “All”.
- As “IPN URL” enter the URL which will run the script on your server.
- For "IPN passphrase" enter the passphrase you set at point 3 of "Prepare the IPN-script".
- As IPN timing, select “Before redirect to thank you page”.
- Make sure “Active” is set to "Yes".
- Click the “Test connection” button and review the result. It should say “OK”.
- Save your changes.
- Start a test order and make sure, the order is processed correctly on your server. Review the IPN log on page Reports > IPN.