--- title: "Callback erstellen" slug: "callback-erstellen-1" description: "Callbacks in Frisbii Media übertragen; Anleitung zu Erstellung, Verwaltung, Authentifizierung und Callback Secret im Merchant Backend." updated: 2026-05-29T11:09:37Z published: 2026-05-29T11:09:37Z canonical: "help.frisbii.com/callback-erstellen-1" --- > ## Documentation Index > Fetch the complete documentation index at: https://help.frisbii.com/llms.txt > Use this file to discover all available pages before exploring further. # Callback erstellen ## Vorbemerkungen **Was sind Callbacks?** Callbacks ermöglichen es, Informationen zu definierten Ereignissen im Frisbii Media-System in quasi Echtzeit auf andere Systeme zu übertragen. Bei der Integration von Frisbii Media ist es möglicherweise gewünscht, dass Drittsysteme Informationen zu Ereignissen empfangen, die im Frisbii Media System auftreten, damit diese Systeme entsprechend Aktionen ausführen können. Zu diesem Zweck können für bestimmte Ereignisse sogenannte Callbacks im Merchant Backend definiert werden. Die Anlage und die Verwaltung erfolgt auf Mandantenebene. > [!NOTE] > **Hinweis zum Datenschutz:** > > Bei der Verwendung der meisten Callback-Typen werden personenbezogene Daten übertragen. Das empfangende System kann daher aus Sicht der geltenden Rechtsprechung als zusätzlicher Auftragsdatenverarbeiter definiert werden. Dies sollte bei der Verwendung von Callbacks berücksichtigt werden. Für Beispiele der Payloads haben wir einen eigenen Eintrag erstellt: [Payloads - Beispiele](/frisbii-media/docs/payloads-beispiele) --- ## Callbacks erstellen und aktivieren ### Callback erstellen (ohne Authentifizierung) 1. In der Aktionsleiste **+ Callback erstellen** anklicken. 2. **URL des eigenen Webservice** eintragen. Sobald die URL eingetragen wurde, kann die Checkbox **Aktiviert** angeklickt werden, um den Callback zu aktivieren. 3. **Callback-Typ** über das Dropdown-Menü auswählen (z. B. "Kunde erstellen"). 4. Einstellungen speichern. Nach dem Speichern generiert das Frisbii Media System automatisch für jeden Callback ein eigenes **Callback Secret**, das beim Öffnen des Callbacks in der Detailansicht eingesehen werden kann. ![](https://cdn.document360.io/b84e1b5d-2ba6-4465-8c62-fb45a2f31314/Images/Documentation/DE(3).png?sv=2026-02-06&spr=https&st=2026-11-10T07%3A02%3A19Z&se=2026-11-10T08%3A02%3A19Z&sr=c&sp=r&sig=qhY4NKTj%2F3YRF%2BkFptyJOloQHO7HSxAfrghDJAuhp4U%3D) --- ### Callback erstellen (mit Authentifizierung) > [!TIP] > **Hinweis**: Wir empfehlen grundsätzlich den Sicherheitsmechanismus durch Authentifizierung zu nutzen. - In der Aktionsleiste **+ Callback erstellen** anklicken. - Checkbox **Endpunkt benötigt Authentifizierung** aktivieren. - **Methode 1: Authentifizierung per Benutzername und Passwort** Durch die Verwendung einer Basic Authentification per Benutzername und Passwort kann die Übertragung der Daten abgesichert werden. Dabei legt in den meisten Fällen das empfangende System die Daten zu Authentifizierung fest. Bei der Verwendung des so abgesicherten Callbacks sind die Daten zu Authentifizierung in jedem Request von Frisbii Media enthalten. - **Methode 2: Authentifizierung per HTTP-Header** HTTP-Header können zusätzlich zur Authentifizierung gegenüber einem Dienst verwendet werden. Dazu ein oder mehrere key-value-Paar(e) eintragen. Nach dem Speichern generiert das Frisbii Media System automatisch für jeden Callback ein eigenes **Callback Secret**, das beim Öffnen des Callbacks in der Detailansicht eingesehen werden kann. ![](https://cdn.document360.io/b84e1b5d-2ba6-4465-8c62-fb45a2f31314/Images/Documentation/DE(4).png?sv=2026-02-06&spr=https&st=2026-11-10T07%3A02%3A19Z&se=2026-11-10T08%3A02%3A19Z&sr=c&sp=r&sig=qhY4NKTj%2F3YRF%2BkFptyJOloQHO7HSxAfrghDJAuhp4U%3D) --- ## Callbacks verwalten Alle erstellten Callbacks werden auf der Übersichtsseite aufgelistet. - Weitere Informationen zu einem bestimmten Callback können durch Klicken auf **Details** aufgerufen werden. - Callbacks können bearbeitet werden, indem **Bearbeiten** angeklickt wird. Dies kann notwendig sein, um den Callback zu deaktivieren oder zu aktivieren, oder um bei fehlgeschlagenen Versuchen die URL des Webservice zu ändern oder den Callback-Typ anzupassen. - Das Callback Log kann nach einer bestimmten Callback-ID durchsucht werden, indem **Log durchsuchen** angeklickt wird. Das [Callback Log](/frisbii-media/docs/callback-log#filter-log) öffnet sich und der Filter für diese spezifische Callback-ID ist bereits gesetzt. --- ## Beispiel Header In folgendem Beispiel wurde sowohl Methode 1 als auch Methode 2 des Sicherheitsmechanismus verwendet. Im Merchant Backend sehen die Einstellungen wie folgt aus: ![](https://cdn.document360.io/b84e1b5d-2ba6-4465-8c62-fb45a2f31314/Images/Documentation/DE(5).png?sv=2026-02-06&spr=https&st=2026-11-10T07%3A02%3A19Z&se=2026-11-10T08%3A02%3A19Z&sr=c&sp=r&sig=qhY4NKTj%2F3YRF%2BkFptyJOloQHO7HSxAfrghDJAuhp4U%3D) Die Authentifizierung wird im **Header** des Callbacks übertragen. Die fettgedruckten Werte sind die entsprechenden Authentifizierungs-Daten, die im Merchant Backend eingestellt wurden. Zudem ist jeder Callback mit einer "plenigo-signature" signiert. Wie die Signatur geprüft werden kann, wird in folgendem Eintrag näher erläutert: [plenigo-Signatur](/frisbii-media/docs/plenigo-signatur-1) | Headers | | --- | | accept-encoding | `gzip` | | x-plenigo-api-version | `20240827` | | **plenigo-signature** | `t=1729583536,s=fdcd0a0ccd0b4db629d35a33c3aada5cf669a28f91adb38abcc9ffcdb1663d38` | | **Test** | **Test2** | | content-type | `application/json` | | authorization | `Basic cGxlbmlnb190ZXN0OjEyMzQ1Njc4OQ==` | | accept | `application/json` | | content-length | `686` | | user-agent | `go-resty/2.15.3 (https://github.com/go-resty/resty)` | | host | `webhook.site` | | **php-auth-user** | `Test` | | **php-auth-pw** | `xxxxxxx` |