50% OFF with code BLACKFRIDAY5020% OFF with code BLACKFRIDAY20
Integrazioni e APITutti i piani

Webhook per i nuovi ordini

Un webhook invia ogni nuovo ordine, e ogni sua modifica, al tuo sistema come messaggio JSON firmato. Dai a Menuthere un indirizzo HTTPS e un segreto, poi verifichi la firma su ogni richiesta. Un pulsante di prova e un registro delle consegne ti permettono di controllare che funzioni.

Dove
Set up by Menuthere support
Piano
La dashboard non blocca i webhook in base al piano.
Tempo
15 min
Aggiornato

Configura un webhook

Passo 1: Invia il tuo indirizzo all'assistenza

I webhook non sono ancora nella dashboard, quindi li configura l'assistenza Menuthere. Invia all'assistenza l'indirizzo che riceverà gli ordini. Deve iniziare con https:// ed essere raggiungibile da internet. Indirizzi come localhost o di una rete privata non possono essere chiamati.

Passo 2: Conserva il segreto di firma

L'assistenza attiva i webhook degli ordini e ti dà un segreto di firma. Tienilo solo sul tuo server. Lo usi per controllare che ogni richiesta arrivi davvero da Menuthere.

Passo 3: Chiedi un evento di prova

Chiedi all'assistenza di inviare un evento di prova. Invia un order.created di esempio al tuo indirizzo, e il risultato mostra Delivered con il codice di risposta del tuo endpoint, oppure cosa è andato storto.

Cosa invia Menuthere

EventoInviato quando
order.createdViene effettuato un ordine.
order.status_updatedLo stato di un ordine cambia, ad esempio accettato, pronto o completato.
payment.status_updatedUn ordine viene segnato come pagato, oppure cambia il suo metodo di pagamento.
delivery.status_updatedViene assegnato un fattorino o cambia lo stato della consegna.
IntestazioneValore
x-menuthere-eventIl nome dell'evento.
x-menuthere-timestampOra Unix in secondi, impostata di nuovo a ogni tentativo.
x-menuthere-signatureUn HMAC-SHA256 esadecimale del corpo grezzo della richiesta, creato con il tuo segreto.

Il corpo è una busta con event, un id univoco, created_at e data. Un evento di prova contiene anche "test": true, quindi ignoralo nella tua cucina. Per order.created, data contiene i campi seguenti.

CampoContenuto
order_id, order_numberL'ID dell'ordine e il numero mostrato al tuo team.
status, type, placed_at, currencyStato attuale, tipo di ordine, ora dell'ordine e valuta.
totalssubtotal, delivery_charge, packing_charge, gst, discount, grand_total.
customername, phone, address.
tablenumber e name del tavolo per un ordine al tavolo, altrimenti vuoto.
itemsOgni riga: name, quantity, unit_price, total_price, variant, notes.
notes, paymentLa nota del cliente, e il method di pagamento e se è is_paid.

Verifica e affidabilità

  • Controlla la firma sul corpo grezzo. Analizzare e ricodificare il JSON cambia spaziatura e ordine, e la firma non corrisponderà.
  • Sii idempotente. Lo stesso id può arrivare due volte. Usalo per evitare una seconda comanda in cucina.
  • Rispondi con un 2xx in fretta. Menuthere aspetta 8 secondi per tentativo e riprova fino a tre volte, dopo 1,5 secondi e poi 5 secondi. Un timeout, un 5xx, un 408 o un 429 vengono ritentati. Qualsiasi altro 4xx è preso come un no voluto e si ferma.
  • Controlla Recent deliveries. Il pannello elenca i tentativi delle ultime 24 ore, dal più recente, con il codice di risposta e l'ora. Ogni nuovo tentativo è una riga a sé.
Da sapereUn endpoint che non funziona non ferma né ritarda mai l'ordine di un cliente.

Domande

Posso indirizzarlo a un server della mia rete?
Non direttamente. L'indirizzo deve essere HTTPS pubblico. Gli indirizzi localhost e di reti private vengono rifiutati.
Posso dire alla mia cassa (POS) che l'ordine è stato accettato?
Il registro delle consegne viene conservato per sempre?
Il pannello mostra i tentativi delle ultime 24 ore.

Non lo trovi? Scrivi a help@mail.menuthere.com o chatta con noi, dalle 9 alle 21.Centro assistenzaPrezzimenuthere.com