Connect Maropost to Digistore24 – Digistore24 Help

Maropost is a comprehensive e-commerce platform. You can connect Maropost to Digistore24. This transfers contacts to Maropost and enters them onto lists.

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

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

Requirements

You already have a Maropost account and know your account ID.
You have created an API key in Maropost and assigned it at least the following permissions:
- Campaigns
- Contact
- Download contacts
- Automations

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 Maropost 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 in 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. Additional input fields will appear depending on what you select here.
If applicable: You can select for which customer order events an IPN should be sent in the For order events field.
If applicable: You can select for which affiliate partnership events an IPN should be sent in the For new affiliates field.
Enter your Account ID from Maropost.
Enter the Key URL of the API key created in Maropost.
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 the one product only.
  Note
  You can use the transfer of tags for different purposes:
  - With the IPNs, additional information is transmitted to the target system.
  - With the IPNs, information provided by default should not be transferred to the target system in general or under certain conditions.
  - The IPNs are intended to remove information already present in 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 several variants of this product.
  
  You want to transfer the product name, product ID, variant name, and 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. He makes his 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 a field, but they must be separated by commas.
  - If a tag name contains a comma, add 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.
If you have entered Tags: Select if and when the tags should be added or removed in the The tags shall be field.
If you have entered Tags: Select whether tags should be transferred upon the first payment only or also upon follow-up payments (subscriptions, installments) in the For payments set/remove tags only for the first payment field.
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.
If you have created additional fields (personalized fields/custom fields) in the target system: You can enter the names of the fields created in the target system to be filled with data submitted by Digistore24 in the Custom Fields, Customers to affiliates, Product, Address, and Amounts sections.
Click on the Save button. A Maropost list can be selected in the E-Mail list field.
Scroll up and, in the E-Mail list field, select the Maropost list to which you want to transfer the contacts.
Click on the Save button. The IPN connection is 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, when a return is made, 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.