API REST i webhooki dla marketplace — sprzedawcy, oferty, zamówienia i prowizje
Wszystko, co składa się na prowadzenie Twojego marketplace, jest dostępne programowo: rejestrujesz sprzedawców, synchronizujesz ich oferty z systemu ERP lub feedu, czytasz zamówienia przypisane do sprzedawcy i śledzisz prowizje oraz wypłaty.
Co obejmuje API marketplace
Onboarding sprzedawcy przez API
Utworzenie sprzedawcy, przekazanie danych firmy i dokumentów weryfikacyjnych, uruchomienie aktywacji — przydatne, gdy pozyskiwanie sprzedawców prowadzisz we własnym CRM.
Oferty i stany magazynowe
Tworzenie i aktualizacja ofert w podziale na sprzedawcę, z ceną, stanem i kategorią. Sprzedawca może wywołać ten sam endpoint własnym kluczem i synchronizować ze swojego systemu.
Zamówienia przypisane do sprzedawcy
Odczyt zamówień już rozbitych na sprzedawców: zamówienie z towarem trzech sklepów wraca jako trzy pozycje, każda z własnym statusem wysyłki.
Prowizje i wypłaty
Odpytanie o prowizję potrąconą przy każdej transakcji i o status wypłaty dla sprzedawcy — podstawa Twoich własnych raportów lub eksportu księgowego.
Webhooki zdarzeń
Rejestrujesz swój adres URL i otrzymujesz zdarzenia nowego zamówienia, płatności, anulowania, zwrotu i aktywacji sprzedawcy — z ponowieniami i podpisem do weryfikacji autentyczności.
Dokumentacja OpenAPI 3
Pełna specyfikacja z przykładami oraz klucz środowiska testowego, żeby Twój zespół pracował na danych próbnych przed dotknięciem prawdziwego marketplace.
Generujesz klucz API z panelu operatora, wybierasz uprawnienia i wywołujesz endpointy REST dla sprzedawców, ofert, zamówień i prowizji. Dla zdarzeń rejestrujesz adres webhooka; nieudane wywołania są ponawiane w rosnących odstępach.
Częste pytania o API i webhooki
Prowadź swój marketplace programowo
Specyfikacja OpenAPI 3, klucz testowy i podpisane webhooki są w każdym planie.