Cosa deve supportare un hotel booking API?

Tariffe e disponibilità in tempo reale, creazione della prenotazione, pagamento e conferma con webhooks. Le API di contenuto in sola lettura coprono solo la prima e non possono completare una transazione.

L’API Wink è gratuita?

Le API Consumer e Booking Engine sono gratuite. La Partner API include 10.000 notti hotel gratuite al mese, poi fattura per unità.

Devo diventare merchant of record?

No. L’hotel resta merchant of record e il pagamento viene raccolto per l’hotel. Esistono accordi merchant-of-record per integrazioni API che hanno davvero bisogno di incassare direttamente, con requisiti di licenza propri.

Gli agenti AI possono prenotare con le stesse funzionalità?

Sì. Un server MCP espone ricerca, quotazione e prenotazione agli agenti, così un assistente può completare una prenotazione invece di rimandare l’utente a un sito web.

Come vengo pagato come integratore?

Si applica una commissione predefinita del 10% sulle prenotazioni generate dal tuo prodotto, calcolata dopo la commissione piattaforma dell’hotel e l’elaborazione carta, con attribuzione che dura 6 mesi per clic.

Devo costruire un’interfaccia utente?

Non necessariamente. I web component forniscono ricerca prenotabile, liste camere e checkout da inserire in una pagina esistente; l’API REST è disponibile quando il flusso deve essere tuo.

Hotel Booking API — Come Aggiungere la Prenotazione Hotel a un Prodotto

Le quattro capacità che contano

Capacità	Cosa significa	Perché i prodotti si bloccano senza
Tariffe e disponibilità in tempo reale	Prezzi attuali e cosa è effettivamente prenotabile, per intervallo di date	Tariffe memorizzate in cache falliscono alla conferma e minano la fiducia
Creazione della prenotazione	Creare una vera prenotazione che l’hotel riceve	Senza questo sei solo un link di referral, non un prodotto
Pagamento	Ricevere denaro come parte della prenotazione	Un passaggio a un altro sito è dove la conversione muore
Conferma e webhooks	Comunicare a ospite, hotel e sistema cosa è successo	Altrimenti supporto e riconciliazione diventano problematici

La maggior parte delle “API hotel” che uno sviluppatore trova coprono la prima e a volte la seconda. La transazione è la parte difficile, ed è quella che decide se hai un prodotto.

Di chi è la disponibilità che stai integrando?

Questa domanda determina tutto ciò che segue. La disponibilità rivenduta attraverso una catena arriva con un ricarico incluso nella tariffa, disponibilità meno aggiornata e nessun canale diretto con l’hotel per domande sulla prenotazione. La disponibilità che arriva direttamente dall’hotel porta la tariffa dell’hotel stesso, disponibilità in tempo reale e un hotel che sa che la prenotazione esiste.

Per tutto ciò che il viaggiatore confronterà con il sito dell’hotel — che è la maggior parte delle cose — la disponibilità controllata dall’hotel evita il momento imbarazzante in cui il tuo prezzo è peggiore.

Chi è il merchant of record

Se costruisci la prenotazione hotel da solo, diventare merchant of record significa assumersi la responsabilità del pagamento, chargeback, rimborsi, gestione fiscale e spesso una licenza da agenzia di viaggi in ogni mercato.

Su Wink l’hotel resta merchant of record e il pagamento viene raccolto per l’hotel, quindi un integratore non eredita questa responsabilità. Gli accordi merchant-of-record sono disponibili per integrazioni API dove un partner ha davvero bisogno di incassare direttamente, e questa strada comporta requisiti di licenza propri.

Tre livelli di integrazione

Web components. Inserisci una ricerca prenotabile, lista camere o checkout in una pagina esistente. Nessun lavoro backend; minimo controllo sul layout.
REST API. Controllo completo su ricerca, tariffe, creazione prenotazione e conferma, autenticata con OAuth2. Usala quando il flusso di prenotazione fa parte dell’esperienza del tuo prodotto.
Server MCP. Le stesse funzionalità esposte per agenti AI, così un assistente può cercare, quotare e completare una prenotazione invece di rimandare l’utente a un sito web.

I tre non sono esclusivi — un prodotto usa comunemente componenti per una superficie marketing e l’API per il flusso principale.

Cosa costruire prima

Ricerca e prezzo per una città e un intervallo di date. Ottieni tariffe reali prima di progettare qualsiasi cosa.
Crea una prenotazione di test end-to-end, inclusi pagamento e conferma.
Iscriviti a booking.create e agli eventi di cancellazione prima di costruire qualsiasi UI sopra.
Decidi presto il modello di attribuzione — il contesto della fonte deve viaggiare con la prenotazione, altrimenti i report saranno congetture.
Gestisci i casi di errore: disponibilità persa tra preventivo e prenotazione, pagamento rifiutato, rimborsi parziali.

Prezzi che uno sviluppatore dovrebbe conoscere

Le API Consumer e Booking Engine sono gratuite. La Partner API include una franchigia mensile gratuita di 10.000 notti hotel, poi fattura per unità. Le prenotazioni confermate portano la commissione piattaforma dell’hotel dell’1,5% più il costo di elaborazione carta, e si applica una commissione predefinita del 10% quando il tuo prodotto ha generato la prenotazione — che è come un integratore guadagna invece di pagare.

Errori comuni

Costruire su tariffe memorizzate in cache. Sembrano a posto in sviluppo ma falliscono in produzione.
Lasciare il pagamento a un redirect. Ogni passaggio perde prenotazioni.
Ignorare i webhooks fino al lancio. La riconciliazione diventa un lavoro manuale.
Diventare merchant of record senza necessità. È una decisione di licenza e responsabilità, non solo tecnica.
Non passare il contesto della fonte. L’attribuzione non può essere ricostruita dopo.

Come fanno gli sviluppatori ad aggiungere la prenotazione hotel a un prodotto?