# 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.

Alle APIs können 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">publisher</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">System-Partnerprogramm</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-API Filter<span class="heading-anchor-wrapper" role="presentation"><button aria-hidden="true" class="css-x4slh0" data-testid="anchor-button" type="button"><span aria-label="Copy" class="_1e0c1o8l _vchhusvi _1o9zidpf _vwz4kb7n _y4ti1igz _bozg1mb9 _12va1onz _jcxd1r8n" role="img"><svg class="_1reo15vq _18m915vq _syaz1r31 _lcxvglyw _s7n4yfq0 _vc881r31 _1bsbpxbi _4t3ipxbi" fill="none" role="presentation" viewbox="0 0 16 16"><path clip-rule="evenodd" d="M8.22 2.22a3.932 3.932 0 1 1 5.56 5.56l-2.25 2.25-1.06-1.06 2.25-2.25a2.432 2.432 0 0 0-3.44-3.44L7.03 5.53 5.97 4.47zm3.06 3.56-5.5 5.5-1.06-1.06 5.5-5.5zM2.22 8.22l2.25-2.25 1.06 1.06-2.25 2.25a2.432 2.432 0 0 0 3.44 3.44l2.25-2.25 1.06 1.06-2.25 2.25a3.932 3.932 0 1 1-5.56-5.56" fill="currentcolor" fill-rule="evenodd"></path></svg></span></button></span>

<div class="pm-table-container with-shadow-observer" data-layout="custom" data-testid="table-container" id="bkmrk-parameter-wert-besch"><div class="pm-table-wrapper" data-autosize="false" data-layout="wide" data-number-column="false" data-table-local-id="1b63a4aa-756d-4c6a-8f6d-1e2a4aeefd72" data-table-width="960" data-vc="table-node-wrapper"><div class="sentinel-left">  
</div><table data-layout="wide" data-number-column="false" data-table-width="960" data-testid="renderer-table" style="width: 100%;"><colgroup><col style="width: 21.9309%;"></col><col style="width: 21.4401%;"></col><col style="width: 39.3466%;"></col><col style="width: 17.2825%;"></col></colgroup><tbody><tr><th aria-sort="none" class="ak-renderer-tableHeader-sortable-column__wrapper" colspan="1" data-colwidth="231" rowspan="1">**Parameter**

</th><th aria-sort="none" class="ak-renderer-tableHeader-sortable-column__wrapper" colspan="1" data-colwidth="168" rowspan="1">**Wert**

</th><th aria-sort="none" class="ak-renderer-tableHeader-sortable-column__wrapper" colspan="1" data-colwidth="257" rowspan="1">**Beschreibung**

</th><th aria-sort="none" class="ak-renderer-tableHeader-sortable-column__wrapper" colspan="1" data-colwidth="304" rowspan="1">**Beispiel**

</th></tr><tr><td colspan="1" data-colwidth="231" rowspan="1">**condition\[period\]\[from\]**

</td><td colspan="1" data-colwidth="168" rowspan="1">Startdatum

</td><td colspan="1" data-colwidth="257" rowspan="1">Definition des Startdatums

</td><td colspan="1" data-colwidth="304" rowspan="1">condition\[period\]\[from\]=19.12.1909

</td></tr><tr><td colspan="1" data-colwidth="231" rowspan="1">**condition\[period\]\[to\]**

</td><td colspan="1" data-colwidth="168" rowspan="1">Enddatum

</td><td colspan="1" data-colwidth="257" rowspan="1">Definition des Enddatums

</td><td colspan="1" data-colwidth="304" rowspan="1">condition\[period\]\[to\]=19.12.1909

</td></tr><tr><td colspan="1" data-colwidth="231" rowspan="1">**condition\[dynamicdate\]**

</td><td colspan="1" data-colwidth="168" rowspan="1">currentmonth = aktueller Monat  
lastmonth = letzter Monat  
last10d = letzten 10 Tage  
currentweek = Aktuelle Woche

</td><td colspan="1" data-colwidth="257" rowspan="1">Definition eines dynamischen Zeitraums.   
(kann <u data-renderer-mark="true">nicht</u> zusammen mit condition\[period\]\[from\] oder condition\[period\]\[to\] ausgewählt werden.

</td><td colspan="1" data-colwidth="304" rowspan="1">condition\[dynamicdate\]=currentweek

</td></tr><tr><td colspan="1" data-colwidth="231" rowspan="1">**condition\[l:projects\]**

</td><td colspan="1" data-colwidth="168" rowspan="1">Zahlenwert, entsprechend des Projekts

</td><td colspan="1" data-colwidth="257" rowspan="1">Alle Transaktionen, welche unter der entsprechenden Projekt-ID des Programms hinterlegt sind. Mehrfachnennung möglich.

</td><td colspan="1" data-colwidth="304" rowspan="1">condition\[l:projects\]=1234

</td></tr><tr><td colspan="1" data-colwidth="231" rowspan="1">**condition\[l:campaigns\]**

</td><td colspan="1" data-colwidth="168" rowspan="1">Zahlenwert, entsprechend der Kampagne

</td><td colspan="1" data-colwidth="257" rowspan="1">Alle Transaktionen, welche unter der entsprechenden Kampagne des Programms hinterlegt sind. Mehrfachnennung möglich.

</td><td colspan="1" data-colwidth="304" rowspan="1">condition\[l:campaigns\]=1

</td></tr><tr><td colspan="1" data-colwidth="231" rowspan="1">**condition\[timetype\]**

</td><td colspan="1" data-colwidth="168" rowspan="1">0 = Transaktionsdatum

1 = Validierungsdatumdatum

2 = Auszahlungsdatum

</td><td colspan="1" data-colwidth="257" rowspan="1">Alle Transaktionen, welche in einem bestimmten Zeitraum erstellt/ generiert/ validiert worden sind.

</td><td colspan="1" data-colwidth="304" rowspan="1">condition\[timetype\]=1

</td></tr></tbody></table>

</div></div># Nachbuchungen per API abfragen

Über die API ist es möglich, **Nachbuchungen (Booking Requests)** auszulesen.  
Dies kann durch Hinzufügen eines speziellen Parameters zum API-Aufruf erfolgen.

<div class="_tableContainer_1rjym_1" id="bkmrk-parameter-wert-besch-1"><div class="group _tableWrapper_1rjym_13 flex w-fit flex-col-reverse" tabindex="-1"><table class="w-fit min-w-(--thread-content-width)" data-end="672" data-start="408"><thead data-end="454" data-start="408"><tr data-end="454" data-start="408"><th data-col-size="sm" data-end="420" data-start="408">Parameter</th><th data-col-size="sm" data-end="427" data-start="420">Wert</th><th data-col-size="md" data-end="442" data-start="427">Beschreibung</th><th data-col-size="sm" data-end="454" data-start="442">Beispiel</th></tr></thead><tbody data-end="672" data-start="505"><tr data-end="672" data-start="505"><td data-col-size="sm" data-end="541" data-start="505">`condition[show_bookingrequests]`</td><td data-col-size="sm" data-end="560" data-start="541">`true` / `false`</td><td data-col-size="md" data-end="630" data-start="560">Zeigt alle Nachbuchungen an, die über das System hochgeladen wurden</td><td data-col-size="sm" data-end="672" data-start="630">`condition[show_bookingrequests]=true`</td></tr></tbody></table>

</div></div><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">get-statistic_campaign.csv?condition[show_bookingrequests]=true</span>`</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="1652" data-start="436" id="bkmrk-feldname-beschreibun"><thead data-end="463" data-start="436"><tr data-end="463" data-start="436"><th data-col-size="sm" data-end="447" data-start="436">Feldname</th><th data-col-size="md" data-end="463" data-start="447">Beschreibung</th></tr></thead><tbody data-end="1652" data-start="494"><tr data-end="532" data-start="494"><td data-col-size="sm" data-end="508" data-start="494">`criterion`</td><td data-col-size="md" data-end="532" data-start="508">Gehashter Ordertoken</td></tr><tr data-end="579" data-start="533"><td data-col-size="sm" data-end="550" data-start="533">`trackingtime`</td><td data-col-size="md" data-end="579" data-start="550">Zeitpunkt der Transaktion</td></tr><tr data-end="620" data-start="580"><td data-col-size="sm" data-end="598" data-start="580">`advertiser_id`</td><td data-col-size="md" data-end="620" data-start="598">ID des Advertisers</td></tr><tr data-end="661" data-start="621"><td data-col-size="sm" data-end="640" data-start="621">`campaign_title`</td><td data-col-size="md" data-end="661" data-start="640">Name der Kampagne</td></tr><tr data-end="697" data-start="662"><td data-col-size="sm" data-end="678" data-start="662">`campaign_id`</td><td data-col-size="md" data-end="697" data-start="678">ID der Kampagne</td></tr><tr data-end="732" data-start="698"><td data-col-size="sm" data-end="713" data-start="698">`project_id`</td><td data-col-size="md" data-end="732" data-start="713">ID des Projekts</td></tr><tr data-end="773" data-start="733"><td data-col-size="sm" data-end="751" data-start="733">`project_title`</td><td data-col-size="md" data-end="773" data-start="751">Titel des Projekts</td></tr><tr data-end="839" data-start="774"><td data-col-size="sm" data-end="784" data-start="774">`event`</td><td data-col-size="md" data-end="839" data-start="784">Typ der Transaktion (z. B. *lead*, *sale*, *bonus*)</td></tr><tr data-end="910" data-start="840"><td data-col-size="sm" data-end="855" data-start="840">`payoutdate`</td><td data-col-size="md" data-end="910" data-start="855">Auszahlungsdatum – leer, wenn noch nicht ausgezahlt</td></tr><tr data-end="986" data-start="911"><td data-col-size="sm" data-end="930" data-start="911">`processingdate`</td><td data-col-size="md" data-end="986" data-start="930">Bearbeitungsdatum – leer, wenn noch nicht bearbeitet</td></tr><tr data-end="1022" data-start="987"><td data-col-size="sm" data-end="1001" data-start="987">`salary_id`</td><td data-col-size="md" data-end="1022" data-start="1001">Interne Salary-ID</td></tr><tr data-end="1052" data-start="1023"><td data-col-size="sm" data-end="1034" data-start="1023">`salary`</td><td data-col-size="md" data-end="1052" data-start="1034">Gutschrifts-ID</td></tr><tr data-end="1091" data-start="1053"><td data-col-size="sm" data-end="1067" data-start="1053">`clicktime`</td><td data-col-size="md" data-end="1091" data-start="1067">Zeitpunkt des Klicks</td></tr><tr data-end="1125" data-start="1092"><td data-col-size="sm" data-end="1102" data-start="1092">`subid`</td><td data-col-size="md" data-end="1125" data-start="1102">Übermittelte Sub-ID</td></tr><tr data-end="1183" data-start="1126"><td data-col-size="sm" data-end="1139" data-start="1126">`referrer`</td><td data-col-size="md" data-end="1183" data-start="1139">Klick-Referrer (Standardwert: `://NONE`)</td></tr><tr data-end="1235" data-start="1184"><td data-col-size="sm" data-end="1199" data-start="1184">`admedia_id`</td><td data-col-size="md" data-end="1235" data-start="1199">ID des Werbemittels (Admedia-ID)</td></tr><tr data-end="1347" data-start="1236"><td data-col-size="sm" data-end="1247" data-start="1236">`status`</td><td data-col-size="md" data-end="1347" data-start="1247">Status der Transaktion:  
`0` = offen  
`1` = bestätigt  
`2` = storniert  
`3` = ausgezahlt</td></tr><tr data-end="1418" data-start="1348"><td data-col-size="sm" data-end="1375" data-start="1348">`reason_of_cancellation`</td><td data-col-size="md" data-end="1418" data-start="1375">Grund der Stornierung (falls vorhanden)</td></tr><tr data-end="1459" data-start="1419"><td data-col-size="sm" data-end="1433" data-start="1419">`provision`</td><td data-col-size="md" data-end="1459" data-start="1433">Provision (Commission)</td></tr><tr data-end="1483" data-start="1460"><td data-col-size="sm" data-end="1473" data-start="1460">`turnover`</td><td data-col-size="md" data-end="1483" data-start="1473">Umsatz</td></tr><tr data-end="1518" data-start="1484"><td data-col-size="sm" data-end="1499" data-start="1484">`trigger_id`</td><td data-col-size="md" data-end="1518" data-start="1499">ID des Triggers</td></tr><tr data-end="1558" data-start="1519"><td data-col-size="sm" data-end="1537" data-start="1519">`trigger_title`</td><td data-col-size="md" data-end="1558" data-start="1537">Name des Triggers</td></tr><tr data-end="1652" data-start="1559"><td data-col-size="sm" data-end="1576" data-start="1559">`basket_count`</td><td data-col-size="md" data-end="1652" data-start="1576">Anzahl der Basket-Items, falls Basket-Tracking aktiv ist (ansonsten `0`)</td></tr></tbody></table>