Connect Ontraport to Digistore24 – Digistore24 Help

Ontraport is a comprehensive tool for customer relationship management (CRM) and business and marketing automation. You can connect Ontraport to Digistore24. This transfers contacts to Ontraport and enters them into lists. By using tags, additional information can be transferred to Ontraport.

To connect Ontraport to Digistore24, you set up an IPN connection for the target system Ontraport in Digistore24.

Note
You have to pay for Ontraport. You can find further information here.

Requirements

You already have an Ontraport account.
You have created an API key in Ontraport and know the app ID (site ID).

If you haven’t created an API key yet, you can find a guide on how to do so here.

Set up IPN connection

Log into your Digistore24 account.
Go to Vendor view and open Settings > Integrations (IPN).
Click on the Add new connection button. An overview of the connections will now be displayed.
Click on the Ontraport card. The input form will now open.
Enter a Name. This is only visible to you.
Select for which products an IPN should be sent in the For products field.
Select whether an IPN should also be sent when the products are purchased as add-ons in the For add-ons field.
You can select for which product languages an IPN should be sent in the For orders in these languages field.
Select for which events an IPN should be sent in the Send notifications for field.
Enter the app ID in the Ontraport site ID field.
Enter the Ontraport API key.
You can enter Tags for your products. The tags are transferred to the target system with the IPNs.
- In the All products field: Enter tags to be transferred for all products.
- Enter tags in the fields of each product that should be transferred for that product only.
  Note
  You can use tags to transfer additional information to the target system.
  
  Example for tags
  You can enter your own information and/or work with placeholders that are automatically filled in, e.g. product ID or variant name.
  
  Example
  
  Your product is a subscription and is called ExampleSubscription. There are different variants of this product.
  
  You want to transfer the product name, the product ID, the name of the variant, and the payment number with the IPN.
  
  To do this, enter the following information in a tag field:
```
ExampleSubscription_{product_id}_{N}, {variant_name}
```
  A buyer has purchased the product variant called SubscriptionVariant. They make their 2nd subscription payment. The IPN therefore transfers the following information:
```
ExampleSubscription_123456_2, SubscriptionVariant
```
  Notes on filling in a tag field
  - You can enter multiple tags in one field, but they must be separated by commas.
  - If a tag name contains a comma, insert a backslash before it in the tag name:
```
\,
```
  Available placeholders
  - ```
  {main_product_id}
```
- ```
{product_id}
```
  - ```
  {quantity}
```
- ```
{variant_id}
```
  - ```
  {variant_name}
```
- ```
{eticket_date}
```
  - ```
  {eticket_hint}
```
- ```
{tag}
```
  - ```
  {campaignkey}
```
- ```
{trackingkey}
```
  - ```
  {N}, {NN}, {NNN}, {NNNN}
```
Note
With these placeholders, the payment number can be adapted to the format of the target system. The leading zeros also allow correct alphabetical sorting in the target system if required.
Select when to send an IPN in the IPN timing field.
Select whether the connection should be active immediately after saving in the Active field.
Select under which conditions an IPN should be sent in the IPN notification is sent field.
Note
You can find more information about this here: Offer newsletter on order form.
You can enter one or more email addresses in the Email address for error notifications field. If errors occur during IPN delivery, you will be notified via these email addresses.
Click on Save. The IPN connection is now set up.

Note
Use the Test connection button to check whether the IPN connection you have set up actually works and IPNs are transferred to the target system.

Tip

You can create multiple IPN connections for a target system and thereby cover different use cases. The use cases that are possible and appropriate also depend on the target system.

Examples

Data is to be transferred to multiple email lists or campaigns.

When a payment is made, the customer should be added to an email list, and when a refund occurs, the customer should be removed from an email list.

For certain products, an IPN should only be sent for customer orders, and for other products, it should also be sent for affiliate partnerships.

Set up a separate IPN connection for each use case for the respective target system.