# Transaktions API - Dokumentation

Die Transaktions API ermöglicht den strukturierten Export und die Analyse von Transaktionen, die im Rahmen des Partnerprogramm-Systems erfasst wurden. Sie bietet detaillierte Einblicke in einzelne Transaktionsvorgänge und unterstützt bei der Abrechnung, Erfolgsmessung sowie der Integration in interne oder externe Systeme.

Die API kann im User-Interface unter dem Menüpunkt **Daten-API** verwendet werden.

---

## API-Aufruf

<div class="contain-inline-size rounded-2xl relative bg-token-sidebar-surface-primary" id="bkmrk-https%3A%2F%2Fwww.domain.d"><div class="overflow-y-auto p-4" dir="ltr">https://**www.<span class="hljs-keyword">domain</span>.de**/api//**<span class="hljs-keyword">ACCESS</span>-TOKEN**/<span class="hljs-keyword">admin</span>/**ID**/get-orders**.csv**</div></div><div class="overflow-y-auto p-4" dir="ltr" id="bkmrk--1"></div><div class="overflow-y-auto p-4" dir="ltr" id="bkmrk-wert-beschreibung-ww"><table class="w-fit min-w-(--thread-content-width)" data-end="1483" data-start="768"><thead data-end="814" data-start="768"><tr data-end="814" data-start="768"><th data-col-size="sm" data-end="780" data-start="768">Wert</th><th data-col-size="xl" data-end="814" data-start="798">Beschreibung</th></tr></thead><tbody data-end="1483" data-start="864"><tr data-end="953" data-start="864"><td data-col-size="sm" data-end="892" data-start="864">www.domain.de</td><td data-col-size="xl" data-end="953" data-start="907">Systemdomain</td></tr><tr><td>ACCESS-TOKEN</td><td>Access Token des Users</td></tr><tr><td>ID</td><td>User-ID</td></tr><tr><td>.csv</td><td>Art des Downloads</td></tr></tbody></table>

</div>---

## Transaktions-API Filterung

Für die Transaktions API können verschiedene Parameter als Filter verwendet werden.  
Nachfolgend eine Übersicht aller verfügbaren Parameter:

**Transaktions Status**

<table class="w-fit min-w-(--thread-content-width)" data-end="1483" data-start="768" id="bkmrk-parameter-wert-%2F-bei"><thead data-end="814" data-start="768"><tr data-end="814" data-start="768"><th data-col-size="sm" data-end="780" data-start="768">Parameter</th><th data-col-size="sm" data-end="798" data-start="780">Wert</th><th>Beispiel</th><th data-col-size="xl" data-end="814" data-start="798">Beschreibung</th></tr></thead><tbody data-end="1483" data-start="864"><tr data-end="953" data-start="864"><td data-col-size="sm" data-end="892" data-start="864">`condition[l:status]`</td><td data-col-size="sm" data-end="907" data-start="892">`open`</td><td>`condition[l:status]=open`</td><td data-col-size="xl" data-end="953" data-start="907">Alle Transaktionen, welche als “Offen” im System hinterlegt sind</td></tr><tr><td>  
</td><td>`confirmed`</td><td>`condition[l:status]=confirmed`</td><td>Alle Transaktionen, welche als “Bestätigt” im System hinterlegt sind</td></tr><tr><td>  
</td><td>`paid`</td><td>`condition[l:status]=paid`</td><td>Alle Transaktionen, welche als “Ausgezahlt” im System hinterlegt sind</td></tr><tr><td>  
</td><td>`canceled`</td><td>`condition[l:status]=canceled`</td><td>Alle Transaktionen, welche als “Storniert” im System hinterlegt sind</td></tr></tbody></table>

**Hinweis:** Es ist eine Kombination aus mehreren Status möglich. Zum Beispiel: `condition[l:status]=confirmed,paid`

<table class="w-fit min-w-(--thread-content-width)" data-end="1483" data-start="768" id="bkmrk-parameter-wert-%2F-bei-1"><thead data-end="814" data-start="768"><tr data-end="814" data-start="768"><th data-col-size="sm" data-end="780" data-start="768">Parameter</th><th data-col-size="sm" data-end="798" data-start="780">Wert / Beispiel</th><th data-col-size="xl" data-end="814" data-start="798">Beschreibung</th></tr></thead><tbody data-end="1483" data-start="864"><tr data-end="953" data-start="864"><td data-col-size="sm" data-end="892" data-start="864">`condition[period][from]`</td><td data-col-size="sm" data-end="907" data-start="892">`01.01.2025`</td><td data-col-size="xl" data-end="953" data-start="907">Definiert das **Startdatum** des Zeitraums</td></tr><tr data-end="1039" data-start="954"><td data-col-size="sm" data-end="980" data-start="954">`condition[period][to]`</td><td data-col-size="sm" data-end="995" data-start="980">`31.01.2025`</td><td data-col-size="xl" data-end="1039" data-start="995">Definiert das **Enddatum** des Zeitraums</td></tr><tr data-end="1174" data-start="1040"><td data-col-size="sm" data-end="1067" data-start="1040">`condition[l:campaigns]`</td><td data-col-size="sm" data-end="1073" data-start="1067">`1`</td><td data-col-size="xl" data-end="1174" data-start="1073">Filtert alle Baskets, die einer bestimmten **Kampagne** zugeordnet sind. Mehrfachnennung möglich.</td></tr><tr data-end="1483" data-start="1175"><td data-col-size="sm" data-end="1199" data-start="1175">`condition[datemode]`</td><td data-col-size="sm" data-end="1240" data-start="1199">`processing`  
`payout`  
`incoming`</td><td data-col-size="xl" data-end="1483" data-start="1240">Bestimmt die Art des Zeitraums:  
• `processing`: Baskets, die im Zeitraum **validiert** wurden  
• `payout`: Baskets, die im Zeitraum **ausgezahlt** wurden  
• `incoming`: Baskets, die im Zeitraum **erfasst** wurden (Transaktionsdatum)</td></tr></tbody></table>

<div class="_tableContainer_1rjym_1" id="bkmrk--3"><div class="group _tableWrapper_1rjym_13 flex w-fit flex-col-reverse" tabindex="-1">  
</div></div>**Beispiel:**

<div class="group _tableWrapper_1rjym_13 flex w-fit flex-col-reverse" id="bkmrk-condition%5Bperiod%5D%5Bfr" tabindex="-1"><div class="contain-inline-size rounded-2xl relative bg-token-sidebar-surface-primary"><div class="overflow-y-auto p-4" dir="ltr">`<span class="hljs-keyword">condition</span>[<span class="hljs-keyword">period</span>][<span class="hljs-keyword">from</span>]<span class="hljs-operator">=</span><span class="hljs-number">01.01</span><span class="hljs-number">.2025</span><span class="hljs-operator">&</span><span class="hljs-keyword">condition</span>[<span class="hljs-keyword">period</span>][<span class="hljs-keyword">to</span>]<span class="hljs-operator">=</span><span class="hljs-number">31.01</span><span class="hljs-number">.2025</span><span class="hljs-operator">&</span><span class="hljs-keyword">condition</span>[datemode]<span class="hljs-operator">=</span>processing`</div></div>---

</div>## Definition der Felder in der Transaktions-API

Die heruntergeladenen Transaktionen (z.B. als `.csv`) enthalten folgende Spalten:

<table class="w-fit min-w-(--thread-content-width)" data-end="3782" data-start="366" id="bkmrk-feldname-beschreibun"><thead data-end="393" data-start="366"><tr data-end="393" data-start="366"><th data-col-size="sm" data-end="377" data-start="366">Feldname</th><th data-col-size="md" data-end="393" data-start="377">Beschreibung</th></tr></thead><tbody data-end="3782" data-start="424"><tr data-end="464" data-start="424"><td data-col-size="sm" data-end="431" data-start="424">`id`</td><td data-col-size="md" data-end="464" data-start="431">Eindeutige ID der Transaktion</td></tr><tr data-end="502" data-start="465"><td data-col-size="sm" data-end="476" data-start="465">`status`</td><td data-col-size="md" data-end="502" data-start="476">Status der Transaktion</td></tr><tr data-end="546" data-start="503"><td data-col-size="sm" data-end="517" data-start="503">`timestamp`</td><td data-col-size="md" data-end="546" data-start="517">Zeitpunkt der Transaktion</td></tr><tr data-end="613" data-start="547"><td data-col-size="sm" data-end="563" data-start="547">`campaign_id`</td><td data-col-size="md" data-end="613" data-start="563">Kampagne, der die Transaktion zugeordnet wurde</td></tr><tr data-end="666" data-start="614"><td data-col-size="sm" data-end="630" data-start="614">`attribution`</td><td data-col-size="md" data-end="666" data-start="630">Betrag der gezahlten Attribution</td></tr><tr data-end="727" data-start="667"><td data-col-size="sm" data-end="695" data-start="667">`delivered_tagcode_count`</td><td data-col-size="md" data-end="727" data-start="695">Anzahl der ausgeführten Tags</td></tr><tr data-end="808" data-start="728"><td data-col-size="sm" data-end="766" data-start="728">`delivered_tagcode_serversided_url`</td><td data-col-size="md" data-end="808" data-start="766">Übermittelter Server-Side-Trackingcall</td></tr><tr data-end="869" data-start="809"><td data-col-size="sm" data-end="824" data-start="809">`ordertoken`</td><td data-col-size="md" data-end="869" data-start="824">Vom Advertiser übermittelte Bestellnummer</td></tr><tr data-end="907" data-start="870"><td data-col-size="sm" data-end="881" data-start="870">`source`</td><td data-col-size="md" data-end="907" data-start="881">Quelle der Transaktion</td></tr><tr data-end="980" data-start="908"><td data-col-size="sm" data-end="923" data-start="908">`project_id`</td><td data-col-size="md" data-end="980" data-start="923">ID des Projekts, dem die Transaktion zugeordnet wurde</td></tr><tr data-end="1054" data-start="981"><td data-col-size="sm" data-end="996" data-start="981">`admedia_id`</td><td data-col-size="md" data-end="1054" data-start="996">Werbemittel-ID, über die die Transaktion erzeugt wurde</td></tr><tr data-end="1118" data-start="1055"><td data-col-size="sm" data-end="1064" data-start="1055">`type`</td><td data-col-size="md" data-end="1118" data-start="1064">Typ der Transaktion (z.B. *Sale*, *Lead*, *View*)</td></tr><tr data-end="1183" data-start="1119"><td data-col-size="sm" data-end="1134" data-start="1119">`commission`</td><td data-col-size="md" data-end="1183" data-start="1134">Provision, die dem Publisher zugeordnet wurde (wird beim Salesabgleich geupdated) </td></tr><tr><td>`source_commission`</td><td>Ursprüngliche Provision (wird nicht geupdated)</td></tr><tr data-end="1288" data-start="1184"><td data-col-size="sm" data-end="1208" data-start="1184">`commission_group_id`</td><td data-col-size="md" data-end="1288" data-start="1208">Provisionsgruppe, in der sich der Publisher bei Transaktionserzeugung befand</td></tr><tr data-end="1354" data-start="1289"><td data-col-size="sm" data-end="1304" data-start="1289">`trigger_id`</td><td data-col-size="md" data-end="1354" data-start="1304">Trigger-ID, die der Transaktion zugeordnet ist</td></tr><tr data-end="1430" data-start="1355"><td data-col-size="sm" data-end="1371" data-start="1355">`description`</td><td data-col-size="md" data-end="1430" data-start="1371">Beschreibung, die bei der Transaktion übermittelt wurde</td></tr><tr data-end="1545" data-start="1431"><td data-col-size="sm" data-end="1449" data-start="1431">`trigger_value`</td><td data-col-size="md" data-end="1545" data-start="1449">Vergütung, die in der entsprechenden Trigger-ID zum Zeitpunkt der Transaktion hinterlegt war</td></tr><tr data-end="1625" data-start="1546"><td data-col-size="sm" data-end="1563" data-start="1546">`trigger_type`</td><td data-col-size="md" data-end="1625" data-start="1563">Art des Triggers (Fixvergütung oder prozentuale Vergütung)</td></tr><tr data-end="1675" data-start="1626"><td data-col-size="sm" data-end="1639" data-start="1626">`turnover`</td><td data-col-size="md" data-end="1675" data-start="1639">Provisionsrelevanter Bestellwert</td></tr><tr><td>`attributed_turnover`</td><td>Attribuierter Bestellwert (falls Attributionsmodell aktiv)</td></tr><tr data-end="1739" data-start="1676"><td data-col-size="sm" data-end="1698" data-start="1676">`original_turnover`</td><td data-col-size="md" data-end="1739" data-start="1698">Bestellwert in der Advertiser-Währung</td></tr><tr data-end="1810" data-start="1740"><td data-col-size="sm" data-end="1754" data-start="1740">`action_id`</td><td data-col-size="md" data-end="1810" data-start="1754">Action-ID, die bei der Transaktion übermittelt wurde</td></tr><tr data-end="1897" data-start="1811"><td data-col-size="sm" data-end="1825" data-start="1811">`salary_id`</td><td data-col-size="md" data-end="1897" data-start="1825">ID des Auszahlungsvorgangs, in dem die Transaktion abgerechnet wurde</td></tr><tr data-end="1970" data-start="1898"><td data-col-size="sm" data-end="1913" data-start="1898">`session_id`</td><td data-col-size="md" data-end="1970" data-start="1913">Session-ID, die bei der Transaktion übermittelt wurde</td></tr><tr data-end="2016" data-start="1971"><td data-col-size="sm" data-end="1990" data-start="1971">`order_currency`</td><td data-col-size="md" data-end="2016" data-start="1990">Währung der Bestellung</td></tr><tr data-end="2076" data-start="2017"><td data-col-size="sm" data-end="2040" data-start="2017">`status_change_date`</td><td data-col-size="md" data-end="2076" data-start="2040">Datum der letzten Statusänderung</td></tr><tr data-end="2149" data-start="2077"><td data-col-size="sm" data-end="2095" data-start="2077">`cancel_reason`</td><td data-col-size="md" data-end="2149" data-start="2095">Stornogrund, falls die Transaktion storniert wurde</td></tr><tr data-end="2214" data-start="2150"><td data-col-size="sm" data-end="2170" data-start="2150">`source_turnover`</td><td data-col-size="md" data-end="2214" data-start="2170">Vom Advertiser übermittelter Bestellwert</td></tr><tr data-end="2281" data-start="2215"><td data-col-size="sm" data-end="2231" data-start="2215">`last_change`</td><td data-col-size="md" data-end="2281" data-start="2231">Timestamp der letzten Änderung der Transaktion</td></tr><tr data-end="2367" data-start="2282"><td data-col-size="sm" data-end="2297" data-start="2282">`user_agent`</td><td data-col-size="md" data-end="2367" data-start="2297">Clientinformationen des Nutzers, der die Transaktion ausgelöst hat</td></tr><tr data-end="2458" data-start="2368"><td data-col-size="sm" data-end="2389" data-start="2368">`order_actions_id`</td><td data-col-size="md" data-end="2458" data-start="2389">Interner Verweis auf den provisionsrelevanten Klick oder Postview</td></tr><tr data-end="2496" data-start="2459"><td data-col-size="sm" data-end="2472" data-start="2459">`bonus_id`</td><td data-col-size="md" data-end="2496" data-start="2472">ID eines Bonus-Laufs</td></tr><tr data-end="2568" data-start="2497"><td data-col-size="sm" data-end="2525" data-start="2497">`customer_journey_status`</td><td data-col-size="md" data-end="2568" data-start="2525">Interne Kennziffer zur Customer Journey</td></tr><tr data-end="2637" data-start="2569"><td data-col-size="sm" data-end="2581" data-start="2569">`ebestid`</td><td data-col-size="md" data-end="2637" data-start="2581">Gehashte Bestellnummer zur Anzeige für den Publisher</td></tr><tr data-end="2688" data-start="2638"><td data-col-size="sm" data-end="2658" data-start="2638">`order_timestamp`</td><td data-col-size="md" data-end="2688" data-start="2658">Timestamp des Orderaufrufs</td></tr><tr data-end="2756" data-start="2689"><td data-col-size="sm" data-end="2710" data-start="2689">`action_timestamp`</td><td data-col-size="md" data-end="2756" data-start="2710">Timestamp der Action, die zur Order führte</td></tr><tr data-end="2796" data-start="2757"><td data-col-size="sm" data-end="2775" data-start="2757">`trigger_title`</td><td data-col-size="md" data-end="2796" data-start="2775">Name des Triggers</td></tr><tr data-end="2832" data-start="2797"><td data-col-size="sm" data-end="2812" data-start="2797">`payoutdate`</td><td data-col-size="md" data-end="2832" data-start="2812">Auszahlungsdatum</td></tr><tr data-end="2888" data-start="2833"><td data-col-size="sm" data-end="2858" data-start="2833">`campaign_group_title`</td><td data-col-size="md" data-end="2888" data-start="2858">Titel der Provisionsgruppe</td></tr><tr data-end="2966" data-start="2889"><td data-col-size="sm" data-end="2907" data-start="2889">`project_title`</td><td data-col-size="md" data-end="2966" data-start="2907">Name des Projekts, dem die Transaktion zugeordnet wurde</td></tr><tr data-end="3045" data-start="2967"><td data-col-size="sm" data-end="2986" data-start="2967">`campaign_title`</td><td data-col-size="md" data-end="3045" data-start="2986">Name der Kampagne, die der Transaktion zugeordnet wurde</td></tr><tr data-end="3124" data-start="3046"><td data-col-size="sm" data-end="3064" data-start="3046">`advertiser_id`</td><td data-col-size="md" data-end="3124" data-start="3064">ID des Advertisers, dem die Transaktion zugeordnet wurde</td></tr><tr><td>`advertiser_title`</td><td>Name des Advertisers, dem die Transaktion zugeordnet wurde</td></tr><tr data-end="3201" data-start="3125"><td data-col-size="sm" data-end="3142" data-start="3125">`publisher_id`</td><td data-col-size="md" data-end="3201" data-start="3142">ID des Publishers, dem die Transaktion zugeordnet wurde</td></tr><tr data-end="3271" data-start="3202"><td data-col-size="sm" data-end="3215" data-start="3202">`referrer`</td><td data-col-size="md" data-end="3271" data-start="3215">Seite, auf der der klickauslösende Vorgang stattfand</td></tr><tr data-end="3330" data-start="3272"><td data-col-size="sm" data-end="3284" data-start="3272">`country`</td><td data-col-size="md" data-end="3330" data-start="3284">Land, in dem die Transaktion erzeugt wurde</td></tr><tr data-end="3394" data-start="3331"><td data-col-size="sm" data-end="3341" data-start="3331">`subid`</td><td data-col-size="md" data-end="3394" data-start="3341">Sub-ID, die bei der Transaktion übermittelt wurde</td></tr><tr data-end="3461" data-start="3395"><td data-col-size="sm" data-end="3417" data-start="3395">`publisher_prename`</td><td data-col-size="md" data-end="3461" data-start="3417">Vorname des Publishers (aus Systemdaten)</td></tr><tr data-end="3529" data-start="3462"><td data-col-size="sm" data-end="3484" data-start="3462">`publisher_surname`</td><td data-col-size="md" data-end="3529" data-start="3484">Nachname des Publishers (aus Systemdaten)</td></tr><tr data-end="3602" data-start="3530"><td data-col-size="sm" data-end="3556" data-start="3530">`publisher_searchtitle`</td><td data-col-size="md" data-end="3602" data-start="3556">Suchtitel des Publishers (aus Systemdaten)</td></tr><tr data-end="3655" data-start="3603"><td data-col-size="sm" data-end="3620" data-start="3603">`basket_items`</td><td data-col-size="md" data-end="3655" data-start="3620">Anzahl der Artikel im Warenkorb</td></tr><tr data-end="3732" data-start="3656"><td data-col-size="sm" data-end="3671" data-start="3656">`sub_status`</td><td data-col-size="md" data-end="3732" data-start="3671">Advertiser-interner Status zur Verwaltung der Transaktion</td></tr><tr data-end="3782" data-start="3733"><td data-col-size="sm" data-end="3748" data-start="3733">`visibility`</td><td data-col-size="md" data-end="3782" data-start="3748">Sichtbarkeit für den Publisher</td></tr><tr><td><span data-path-to-node="20,51,0,0">`external_sources_entity_id`  
</span></td><td><span data-path-to-node="20,51,1,0">(Account) Id der externen Quelle</span></td></tr><tr><td>`<span data-path-to-node="20,51,0,0">external_sources_currency_code<br></br></span>`</td><td>Währungscode aus der externen Quelle</td></tr><tr><td>`<span data-path-to-node="20,51,0,0">external_sources_currency_rate<br></br></span>`</td><td>Umrechnungsrate anhand des `<span data-path-to-node="20,51,0,0">external_sources_currency_code</span>` und der internen Währung</td></tr><tr><td>`<span data-path-to-node="20,51,0,0">external_sources_turnover<br></br></span>`</td><td>Bestellwert aus der externen Quelle</td></tr><tr><td>`<span data-path-to-node="20,51,0,0">source_project_id<br></br></span>`</td><td>Publisher/Project-ID aus der externen Quelle</td></tr><tr><td>`<span data-path-to-node="20,51,0,0">source_project_title<br></br></span>`</td><td>Publisher/Project-Name aus der externen Quelle</td></tr><tr><td>`<span data-path-to-node="20,51,0,0">turnover_brutto<br></br></span>`</td><td>Bestellwert inkl. Steuern</td></tr></tbody></table>

<div class="group _tableWrapper_1rjym_13 flex w-fit flex-col-reverse" id="bkmrk--4" tabindex="-1"><div class="_tableContainer_1rjym_1"><div class="group _tableWrapper_1rjym_13 flex w-fit flex-col-reverse" tabindex="-1">  
</div></div></div>