API & Webhooks

4marketplace-Lösungen · API & Webhooks

REST-API und Webhooks für Marktplätze — Händler, Angebote, Bestellungen und Provisionen

Alles, was den Betrieb Ihres Marktplatzes ausmacht, ist programmatisch erreichbar: Händler aufnehmen, deren Angebote aus einem ERP oder Feed synchronisieren, die pro Händler gerouteten Bestellungen auslesen und Provisionen sowie Auszahlungen nachverfolgen.

Was die Marktplatz-API abdeckt

Händler-Onboarding per API

Händler anlegen, Firmendaten und Prüfdokumente übergeben, Freischaltung auslösen — sinnvoll, wenn die Händlerakquise über Ihr eigenes CRM läuft.

Angebote und Bestände

Angebote pro Händler anlegen und aktualisieren, mit Preis, Bestand und Kategorie. Ein Händler kann denselben Endpunkt mit seinem eigenen Schlüssel nutzen und aus Shopware oder JTL synchronisieren.

Bestellungen pro Händler geroutet

Bestellungen auslesen, bereits aufgeteilt nach Händler: eine Bestellung mit Artikeln von drei Händlern kommt als drei Positionen mit jeweils eigenem Versandstatus zurück.

Provisionen und Auszahlungen

Die einbehaltene Provision je Transaktion und den Auszahlungsstatus je Händler abfragen — die Grundlage für Ihre eigene Auswertung oder Ihr Buchhaltungsexport.

Webhooks für Ereignisse

Sie registrieren Ihre URL und erhalten Ereignisse zu neuer Bestellung, Zahlung, Storno, Rückerstattung und Händlerfreischaltung — mit Wiederholversuchen und Signatur zur Prüfung der Echtheit.

OpenAPI-3-Dokumentation

Vollständige Spezifikation mit Beispielen, dazu ein Sandbox-Schlüssel, damit Ihr Team gegen Testdaten entwickelt, bevor es auf den echten Marktplatz geht.

Sie erzeugen im Betreiber-Backend einen API-Schlüssel, wählen die Berechtigungen und rufen die REST-Endpunkte für Händler, Angebote, Bestellungen und Provisionen auf. Für Ereignisse registrieren Sie Ihre Webhook-URL; fehlgeschlagene Aufrufe werden mit ansteigendem Abstand wiederholt.

Häufige Fragen zu API und Webhooks

Ja. Neben dem Betreiberschlüssel erhält jeder Händler im Verkäuferbereich einen eigenen Schlüssel, dessen Rechte auf die eigenen Angebote und Bestellungen begrenzt sind.

Betreiben Sie Ihren Marktplatz programmatisch

OpenAPI-3-Spezifikation, Sandbox-Schlüssel und signierte Webhooks sind in jedem Tarif enthalten.