Controlla la parità per booking engine e gruppi alberghieri.
Confrontiamo la tariffa diretta di ogni hotel con Booking.com, Expedia e i portali che monitora nei risultati di ricerca degli hotel. Quando due rilevazioni concordano, la discrepanza entra nell’elenco dell’hotel. Il webhook firmato qui sotto invia ogni nuova discrepanza tariffaria al tuo endpoint.
Content-Type: application/json
webhook-id: ns4k8w2q7c1m9x5t3h6v0b2r8d7f4j1g
webhook-timestamp: 1791549711
webhook-signature: v1,Xq0c…e21a=
{
"version": 4,
"id": "ns4k8w2q7c1m9x5t3h6v0b2r8d7f4j1g",
"event": "disparity.opened",
"disparityId": "jn7cq2b1x9d8w4fzr3m6kt5v0h7s2e8a",
"hotel": { "id": "kd72mbx0vy4p9s1c6tqh8wf3gr5n2j7e", "name": "Hotel Aurora" },
"ota": "booking",
"stayDate": "2026-10-16",
"occupancy": 2,
"currency": "EUR",
"directPriceMinor": 18800,
"otaPriceMinor": 17900,
"deltaMinor": 900,
"directPriceEurMinor": 18800, "otaPriceEurMinor": 17900, "deltaEurMinor": 900,
"deltaPct": 4.79,
"trust": "seen_twice",
"findingKind": "rate_disparity",
"evidence": { … },
"detectedAt": "2026-10-09T12:02:00.000Z"
}A scopo illustrativo. Hotel Aurora non esiste.
Non legato a un solo booking engine.
Prendiamo la tariffa diretta di ogni hotel dai risultati di ricerca degli hotel, quindi copriamo già oggi hotel con qualsiasi booking engine.
Dai risultati di ricerca degli hotel
Usiamo il prezzo che il sito ufficiale di ogni hotel mostra nei risultati di ricerca degli hotel (Google Hotels), per la stessa notte e gli stessi ospiti dei portali.
Niente da installare
Nessun accesso al booking engine, al channel manager o al PMS, e nulla sul sito dell’hotel. Il nostro team configura ogni hotel.
Gli stessi controlli per ogni hotel
Qualunque booking engine usi, ogni hotel ha gli stessi controlli, un proprio elenco e le stesse notifiche.
Una notifica firmata quando si apre una discrepanza tariffaria.
Invia JSON all’endpoint configurato per l’hotel. Il campo version indica la versione del formato.
Campi del messaggio
- version
- La versione attuale è 4. Possono essere aggiunti campi senza cambiarla; ignora quelli sconosciuti.
- id
- Identificatore dell’invio. Rimane uguale nei tentativi successivi, nel corpo e in webhook-id. Usalo per evitare duplicati.
- event
- disparity.opened indica una nuova discrepanza. È l’unico evento disponibile.
- disparityId
- Identificatore della discrepanza.
- hotel
- Identificatore e nome dell’hotel in StayParity.
- ota
- Codice del canale in minuscolo: booking, expedia o il portale presente nei risultati di ricerca.
- stayDate
- Data del soggiorno in formato YYYY-MM-DD.
- occupancy
- Numero di ospiti per camera.
- currency
- Valuta dell’hotel, codice ISO 4217 come EUR o RON. I tre campi successivi sono espressi in questa valuta.
- directPriceMinor
- Tariffa diretta dell’hotel in unità minori della sua valuta.
- otaPriceMinor
- Tariffa del canale in unità minori della valuta dell’hotel.
- deltaMinor
- Quanto in meno chiede il canale, in unità minori della valuta dell’hotel.
- directPriceEurMinor
- Tariffa diretta in centesimi di euro.
- otaPriceEurMinor
- Tariffa del canale in centesimi di euro.
- deltaEurMinor
- Differenza tra la tua tariffa e quella inferiore del canale, in centesimi.
- deltaPct
- Differenza come percentuale della tariffa diretta, con due decimali.
- trust
- Sempre seen_twice: due rilevazioni dei risultati di ricerca degli hotel ad almeno 30 minuti di distanza, sulla stessa base, con prezzi entro l’1% l’uno dall’altro.
- reason
- now_over_threshold quando una discrepanza già aperta sotto le tue soglie le ha superate in seguito. Assente su una nuova.
- findingKind
- Sempre rate_disparity: la stessa camera, alle stesse condizioni, più economica sul portale.
- evidence
- La prima rilevazione della discrepanza e la più recente, ognuna con le due offerte come sono state rilevate: prezzo, fonte, momento, camera, pasti e condizioni di cancellazione.
- detectedAt
- Momento della prima rilevazione in UTC.
Invio e nuovi tentativi
- POST con Content-Type application/json a un indirizzo HTTPS pubblico
- Una risposta 2xx entro 10 secondi conferma la ricezione
- Risposte 5xx e timeout generano nuovi tentativi a intervalli crescenti
- Le risposte 4xx sono rifiuti e non vengono ritentate
- Non seguiamo reindirizzamenti; indica l’indirizzo finale
Criteri di notifica
- Si applicano le soglie di importo e percentuale di ogni hotel
- Si inviano le discrepanze dei portali che l’hotel monitora, per la stessa camera dell’hotel, entrambe abbinate a una delle tipologie di camera dell’hotel. Quelle in cui non è indicata nessuna camera restano nell’elenco e nel riepilogo via email
- L’evento viene creato all’apertura della discrepanza, non ripetutamente mentre resta aperta
- Puoi usare un endpoint per hotel o uno comune per più hotel
HMAC-SHA256 su identificatore, timestamp e corpo originale.
La firma segue Standard Webhooks. Puoi utilizzare le librerie ufficiali.
webhook-id: <the payload's id>
webhook-timestamp: <unix seconds>
webhook-signature: v1,<base64 HMAC‑SHA256>- 1Leggi webhook-id, webhook-timestamp (secondi Unix) e webhook-signature. La firma contiene v1, una virgola e il valore in base64.
- 2Calcola HMAC-SHA256 su id.timestamp.body, con punti come separatori e senza modificare il corpo. Rimuovi whsec_ dal segreto e decodifica il resto da base64.
- 3Confronta le due firme a tempo costante e rifiuta un timestamp troppo lontano dall’ora attuale, così una richiesta intercettata non può essere inviata di nuovo.
- 4I nuovi tentativi mantengono webhook-id e vengono firmati con un nuovo timestamp.
Ogni account ha un segreto per tutti i suoi hotel. Un amministratore lo crea nell’applicazione e viene mostrato una sola volta. Un nuovo segreto sostituisce il precedente.
Verifica in Node.js
import { createHmac, timingSafeEqual } from "node:crypto";
// Or let the official library do it: npm install standardwebhooks, then
// new Webhook(secret).verify(rawBody, headers) throws unless it checks out.
// rawBody: the request body exactly as it arrived, before JSON.parse.
// headers: the request headers, with Node's lower-case names.
// secret: your whole signing secret, whsec_ prefix included.
function verify(rawBody, headers, secret, toleranceSeconds = 300) {
const id = headers["webhook-id"];
const timestamp = Number(headers["webhook-timestamp"]);
if (!id || !Number.isInteger(timestamp)) return false;
if (Math.abs(Date.now() / 1000 - timestamp) > toleranceSeconds) return false;
const key = Buffer.from(secret.replace(/^whsec_/, ""), "base64");
const expected = createHmac("sha256", key).update(`${id}.${timestamp}.${rawBody}`).digest();
return String(headers["webhook-signature"] ?? "").split(" ").some((entry) => {
const [version, signature = ""] = entry.split(",", 2);
const given = Buffer.from(signature, "base64");
return version === "v1" && given.length === expected.length && timingSafeEqual(given, expected);
});
}Esempi Python e PHP, nuovi tentativi e test nella documentazione
Tutte le strutture in un unico account.
Per un gruppo alberghiero, o per gli hotel che ci porti come partner.
Ogni hotel, il suo elenco
Ogni hotel ha le sue discrepanze e la sua regola di notifica, e nell’applicazione passi da un hotel all’altro.
Il tuo team, con i ruoli
Gli amministratori gestiscono il team e il segreto di firma. I membri gestiscono l’elenco e configurano le notifiche.
Configurato da noi
Il nostro team aggiunge ogni hotel, la sua regola di notifica e gli accessi del tuo team. I tuoi hotel non installano nulla.
Segnalaci i tuoi hotel, o rivendi StayParity.
Dicci come lavori con gli hotel e definiamo insieme le condizioni.
Segnala
Presentaci gli hotel con cui lavori. Li configuriamo noi e ce ne occupiamo.
Rivendi
Offri StayParity ai tuoi hotel insieme a quello che già vendi loro.
Cosa chiedono prima i partner.
No. Usiamo il prezzo che i risultati di ricerca degli hotel mostrano per il sito ufficiale di ogni hotel, qualunque booking engine usi.
Non ancora. La tariffa diretta di ogni hotel è quella che i risultati di ricerca degli hotel mostrano per il suo sito ufficiale. Se gestisci un booking engine e vuoi che prendiamo i prezzi dei tuoi hotel direttamente da lì, scrivici.
Dall’elenco di ogni hotel e dal suo riepilogo giornaliero o settimanale via email, e il webhook invia ogni nuova discrepanza tariffaria al tuo endpoint quando si apre. Se ti serve un dato che il webhook non invia, diccelo.
Niente, per i controlli e le notifiche. Il widget per prenotazioni dirette è un tag script sul sito dell’hotel, e solo se l’hotel lo vuole.
Inserisci il tuo sito. Controlliamo le prossime 30 notti.
Senza carta né installazione. Le prossime 30 notti, confrontate con Booking.com, Expedia e le altre grandi OTA.