Note
Important requirement for setting up the S2S postback
As an Affiliate...
- You need an approved partnership with the product vendor.
- You need a promo or content link to promote the product.
As a Vendor...
- You need an approved product.
- You need a sales page with a Buy button linking to a Digistore24 order form.
- You need a promo link or content link for your product.
Warning
This procedure only works with marketing software that supports S2S postback URLs! If you're unsure whether your marketing software has this feature, please contact your marketing system's support.
S2S postback is a tracking method you can use as both a vendor and an affiliate to notify your marketing software (e.g., Klick-Tipp) about sales and earnings you achieve. Learn more about the basics of the S2S postback process here.
Once you meet the above criteria, proceed as follows.
Step 1: Enter Promo or Content Link into Marketing System as Vendor/Affiliate
- Make sure you have a Digistore24 promo or content link. This also applies to you as a vendor.
- Create an advertising link in your marketing software. For the target URL, enter your Digistore24 promo or content link.
- Add a GET parameter to your Digistore24 promo or content link to transmit the Click-ID. Digistore24 uses the parameter name cid for transmitting the Click-ID. You can find more placeholders here.
- Next, add the Click-ID placeholder of your marketing system as a value (see Example 1).
Example 1: Screenshot of BeMob
Note
If you can't find an option to insert a Click-ID placeholder in your marketing system, please contact your marketing software support.
Your promo or content link should look like this:
Promo Link
https://www.digistore24.com/redir/[PRODUCT-ID]/[AFFILIATE-ID]/[CAMPAIGNKEY]?cid=[CLICK-ID-PLACEHOLDER]
Example: https://www.digistore24.com/redir/123456/MaxMuster/FacebookCampaign?cid={click_id}
Content Link
https://www.digistore24.com/content/[PRODUCT-ID]/[CONTENTLINK-ID]/[AFFILIATE-ID]/[CAMPAIGNKEY]?cid=[CLICK-ID-PLACEHOLDER
Example: https://www.digistore24.com/content/123456/20581/MaxMuster/FacebookCampaign?cid={click_id}
All text between the brackets should be replaced:
- [PRODUCT-ID]: ID of the product you want to promote
- [CONTENT LINK ID]: ID of your content link
- [YOUR AFFILIATE-ID]: your Digistore24 ID
- [CAMPAIGNKEY]: the campaign key you want to use to label your campaign – this can be left empty
- [CLICK-ID-PLACEHOLDER]: Your marketing system should have the option to add a placeholder to the URL that will automatically be replaced with the Click-ID.
Tip
For advanced users: Digistore24 also allows you to add up to five Sub-IDs as additional GET parameters (sid1 to sid5).
Example: https://www.digistore24.com/redir/123456/MaxMuster/FacebookCampaign?cid={click_id}&sid1={value}&sid2={value}&sid3={value}&sid4={value}&sid5={value}
Warning
Please note the character limit: Your campaign key, Click-ID, and Sub-IDs may only contain uppercase and lowercase letters (including umlauts), the digits 0–9, and the special characters . , _ and - (period, comma, underscore, and hyphen). Your Click-ID and Sub-IDs must also not exceed a total of 1000 characters, and your campaign key may not be longer than 127 characters.
Step 2: Enter Postback URL in Digistore24
- As a Vendor, go to Settings – IPN.
As an Affiliate, go to Account > S2S Postback. - Click Add New Integration at the top left.
As a Vendor, scroll down to the last section and click the S2S Postback icon. - Enter a name for the S2S postback integration. This is only visible to you.
- As a Vendor, choose which products you want to activate the S2S postback for.
As an Affiliate, choose which affiliate partnerships to activate the S2S postback for. - Choose which order events will trigger data transmission to your marketing software.
- Now enter the valid Postback URL of your marketing system.
Warning
Remember to adjust the parameter names to those used by your marketing software. If you’re unsure which parameter names your marketing system uses, please contact its support team. - Next, instead of using specific values, enter the appropriate placeholders provided by Digistore24. You can find them here.
Example: Using the parameters "cid" and "payout", your Postback URL might look like this:https://domain.com/postback?cid={cid}&payout={amount_affiliate}
- Choose the currency in which the amounts should be passed.
Tip
If your marketing system collects your earnings data in US dollars, it makes sense to set Digistore24 to also pass your earnings to your marketing software in US dollars. - Ensure that the integration is active.
- Optional: Enter an email address to be notified in case of errors. This allows you to quickly intervene if something goes wrong with the connection.
- Click Save.
Step 3: Test the S2S Postback
After configuring the S2S postback, follow these steps to test it:
- As a Vendor, go to Settings – IPN.
As an Affiliate, go to Account > S2S Postback. - Click the edit icon next to the desired S2S postback connection.
- Scroll to the bottom of the form.
- Click Test Connection.
This will simulate a purchase and send the data to your marketing software, testing the connection.
Test Purchase:
- As an Affiliate, you cannot perform a test purchase for the products you promote. Contact the product vendor to arrange a test purchase.
- As a Vendor, you can conduct test purchases for your products.
You can also view the call logs:
- As an Affiliate, find the log under Account > S2S Postback in the Log tab.
- As a Vendor, find the log under Reports – Integrations (IPN).
Placeholder List for the S2S Postback URL
Information | Placeholder | Description | Example |
Click-ID | {cid} | The ID used by your tracking system to attribute the purchase to a specific click. | e.g., 123456789 |
Campaign Key | {campaignkey} | In each promo link, you can include a campaign key to later distinguish between campaigns. | e.g., Facebook Campaign |
Country | {country} | The country where the purchase was made, based on the buyer's IP address. | e.g., Germany |
Affiliate Amount | {amount_affiliate} | The amount you earn from the referred sale. | e.g., €15.03 |
Gross Amount | {amount_brutto} | The gross amount of the purchased product. | e.g., €99.99 |
Net Amount | {amount_netto} | The net amount of the purchased product. | e.g., €84.03 |
Currency | {currency} | The currency in which the product was purchased. | e.g., EUR |
Product ID | {product_id} | The ID of the purchased product. | e.g., 62686 |
Product Name | {product_name} | The name of the purchased product. | e.g., How to Be Happy Made Easy |
Transaction ID | {transaction_id} | The ID of the transaction. | e.g., 286230 |
Transaction Type | {transaction_type} | The type of transaction resulting from the order. | e.g., payment |
Vendor ID | {merchant_id} | The Digistore24 ID of the vendor. | e.g., AnnasShop |
Vendor Name | {merchant_name} | The vendor's full name (if visible to you). | e.g., Max Mustermann |
Payment Status | {billing_status} | The buyer's payment status. | paying, completed, aborted |
Billing Type | {billing_type} | How the buyer paid for the product. | single_payment, subscription, installment |
Order Type | {order_type} | Indicates the product's role in this sales funnel. | initial_sale, upsell |
Upsell Number | {upsell_no} | Indicates the position of the product in the sales funnel. | e.g., 3 (= third upsell) |
Test Payment/No Test Payment | {is_test} | Indicates whether this order is a test payment. | e.g., 1 (= test payment) |
Affiliate ID | {affiliate_id} | Your Digistore24 ID. | e.g., max_affiliate |
Affiliate Name | {affiliate_name} | Your full name. | e.g., Max Mustermann |
Date and Time | {datetime_unix}{datetime_full}{datetime_utc} | Date and time, available in three formats. | e.g., 1570216877 |
Random String | {random} | A randomly generated string (to potentially avoid caching issues). | e.g., 2nc91mx82 nv912kcx81be8c |