API REST e webhook per marketplace — venditori, annunci, ordini e commissioni
Tutto ciò che riguarda la gestione del tuo marketplace è raggiungibile via codice: registri i venditori, sincronizzi i loro annunci da un ERP o da un feed, leggi gli ordini instradati per venditore e monitori commissioni e payout.
Cosa copre l API del marketplace
Onboarding venditore via API
Creare un venditore, trasmettere i dati aziendali e i documenti di verifica, avviare l attivazione — utile quando l acquisizione dei venditori passa dal tuo CRM.
Annunci e giacenze
Creare e aggiornare gli annunci per venditore, con prezzo, giacenza e categoria. Un venditore può chiamare lo stesso endpoint con la propria chiave e sincronizzare dal suo gestionale.
Ordini instradati per venditore
Leggere gli ordini già suddivisi per venditore: un ordine con articoli di tre negozi torna come tre righe, ognuna con il proprio stato di spedizione.
Commissioni e payout
Interrogare la commissione trattenuta su ogni transazione e lo stato del payout per venditore — la base per i tuoi report o per l export contabile.
Webhook per gli eventi
Registri il tuo URL e ricevi gli eventi di nuovo ordine, pagamento, annullamento, rimborso e attivazione del venditore — con nuovi tentativi e firma per verificare l autenticità.
Documentazione OpenAPI 3
Specifica completa con esempi, più una chiave sandbox perché il tuo team sviluppi su dati di prova prima di toccare il marketplace reale.
Generi una chiave API dal pannello operatore, scegli i permessi e chiami gli endpoint REST per venditori, annunci, ordini e commissioni. Per gli eventi registri il tuo URL di webhook; le chiamate non riuscite vengono ritentate a intervalli crescenti.
Domande frequenti su API e webhook
Gestisci il tuo marketplace via codice
Specifica OpenAPI 3, chiave sandbox e webhook firmati sono inclusi in tutti i piani.