The newest version of this document can be found online at: https://resources.apnet.ch/api/onlineshop
Last modified: 2022-02-25 15:23 ➔ reload

English version

Anbindung eines Onlineshop an TCS-Benefits

Grundvoraussetzungen

Der "Partner" (die Firma hinter dem Online Shop) muss mit apNet (Betreiber von TCS-Benefits) Kontakt aufnehmen, die Details besprechen und einen Cashback-Satz vereinbaren.
Danach kann der Partner über die unten aufgeführten Möglichkeiten seinen Shop an das System von TCS-Benefits anbinden.

Anbindung via API

TCS-Benefits stellt eine API zur Verfügung, über die sogenannte "Transaktionen" (Details zu Kauf oder Buchung) angeliefert werden können.

Diese API sollte nach Möglichkeit in "realtime" aufgerufen werden, so dass der Kunde von der TCS App sofort über den bezogenen Cashback informiert werden kann.
Ist es einem Partner nicht möglich diese API im Prozess in Realtime anzusprechen, so ist die Mindestanforderung die, dass die Daten mindestens einmal pro Tag via Batch (über dieselbe API) angeliefert werden.

Die Anbindung der API sehr einfach, die Dokumentation (in Englisch) selbsterklärend und der Ablauf ist in der Regel wie folgt:

  1. Der Kunde findet den Partner in der App oder im Web von TCS
  2. Der Kunde loggt sich ein und klickt dann auf den «Shop»-Link auf der Partner-Detailseite in der App oder im Web von TCS
    ➔ hier ein Beispiel einer solchen Detailseite
  3. Der Partner-Shop bekommt via URL eine User-ID als GET-Parameter übermittelt und speichert diese in der Session
  4. Der Kunde kauft oder bucht ein Produkt oder eine Dienstleistung
  5. Der Partner-Shop übermittelt die von TCS-Benefits benötigten Daten zu dem Vorgang via API an TCS-Benefits
    ➔ siehe entsprechende Methode in der API
  6. Ist der Einkauf / die Buchung stornierbar, so muss die Transaktion zwingend als "temporär" markiert werden
    ➔ siehe entsprechende Infos in der API zum Umgang mit temporären Transaktionen
  7. Sobald der Kunde nicht mehr stornieren / zurücksenden / zurücktreten kann oder im Fall einer Buchung diese angetreten / abgeschlossen ist, dann markiert der Partner-Shop die zuvor übermittelte Transaktion als «definitiv»
    ➔ siehe entsprechende Methode in der API
    ➔ Alternativ gibt es auch die Möglichkeit eine bestimmte Anzahl an Tagen zu definieren, nach denen die temporäre Transaktion durch das System von TCS-Benefits automatisch auf "definitiv" gestellt wird. Das kann z.B. dann sinnvoll sein, wenn ein Partner eine ganz klar definierte Rücksende- oder Rücktrittsfrist hat.
  8. Ende des Monats werden die als definitiv markierten Transaktionen von apNet verarbeitet, dem Partner in Rechnung gestellt (Cashback-Betrag + Provision) und der Cashback-Betrag wird dem Kunden von apNet ausgezahlt

Anbindung via Affiliate-Netzwerk

Ist eine entsprechende Erweiterung für die Anbindung via API für Ihren Onlineshop nicht möglich aber SIe sind in der Lage Affiliate-Plugins zu Installieren, so könnte das eine alternative Möglichkeit sein.
TCS-Benefits unterstützt die Anlieferung von Transaktionen via Affiliate-Netzwerk (aktuell: Connects, CJ, Tradedoubler, Awin, Adtraction, Partnerize).

Dies ist zwar für den Partner mittel- bis langfristig kostspieliger, da das Affiliate-Netzwerk ebenfalls eine Provision verlangt aber wenn es keine Möglichkeit für eine direkte Anbindung gibt, dann ist das eine mögliche Alternative.

Für diese Lösung setzen Sie sich bitte mit apNet in Verbindung.

Anbindung via QR-Code

Ist weder eine Anbindung via API, noch eine via Affiliate-Netzwerk möglich oder kostengünstig genug, so gibt es noch die Möglichkeit allen Rechnungen / Zahlungs- oder Buchungsbestätigungen einen QR-Code beizufügen.
Dieser Code muss vom Shop generiert werden und beinhaltet alle relevanten Informationen zum Einkauf / der Buchung.
Ergänzend zu dem Code kann ein Text mitgeliefert werden, der dem Kunden mitteilt, dass er mit dem Scannen dieses Codes und einer aktiven TCS Mitgliedschaft von einem Cashback profitieren kann.

Der Kunde kann dann mit der TCS App diesen Code scannen und bekommt den Cashback dann automatisch gutgeschrieben.

ACHTUNG: Bei diesem Verfahren ist kein Storno möglich, da es keine "temporären" Transaktionen gibt!

Hier finden Sie die Dokumentation für die Generierung eines entsprechenden QR-Codes (in Englisch).