Vai al contenuto

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.

POSThttps://pms.example.com/hooks/paritydisparity.opened
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>
  1. 1Leggi webhook-id, webhook-timestamp (secondi Unix) e webhook-signature. La firma contiene v1, una virgola e il valore in base64.
  2. 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.
  3. 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.
  4. 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

JavaScript
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.

Inizia la prova gratuita

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.