Τι πρέπει να υποστηρίζει ένα API κράτησης ξενοδοχείου;

Ζωντανές τιμές και διαθεσιμότητα, δημιουργία κράτησης, πληρωμή και επιβεβαίωση με webhooks. Τα APIs μόνο για ανάγνωση περιεχομένου καλύπτουν μόνο το πρώτο και δεν μπορούν να ολοκληρώσουν συναλλαγή.

Είναι δωρεάν η χρήση του Wink API;

Τα Consumer και Booking Engine APIs είναι δωρεάν. Το Partner API περιλαμβάνει 10.000 δωρεάν διανυκτερεύσεις ξενοδοχείου ανά μήνα, μετά χρεώνει ανά μονάδα.

Μπορούν οι AI agents να κάνουν κράτηση μέσω των ίδιων δυνατοτήτων;

Ναι. Ένας MCP server εκθέτει αναζήτηση, τιμολόγηση και κράτηση σε agents, ώστε ένας βοηθός να μπορεί να ολοκληρώσει κράτηση αντί να παραπέμπει τον χρήστη σε ιστότοπο.

Πώς πληρώνομαι ως ενσωματωτής;

Εφαρμόζεται προκαθορισμένη προμήθεια 10% στις κρατήσεις που οδήγησε το προϊόν σας, υπολογιζόμενη μετά την προμήθεια πλατφόρμας του ξενοδοχείου και την επεξεργασία κάρτας, με απόδοση που διαρκεί 6 μήνες ανά κλικ.

Χρειάζεται να φτιάξω UI;

Όχι απαραίτητα. Τα web components παρέχουν αναζήτηση με δυνατότητα κράτησης, λίστες δωματίων και checkout που ενσωματώνονται σε υπάρχουσα σελίδα· το REST API είναι εκεί όταν η ροή πρέπει να είναι δική σας.

Hotel Booking API — Πώς να Προσθέσετε Κράτηση Ξενοδοχείου σε ένα Προϊόν

Q: Πρέπει να γίνω merchant of record;

Όχι. Το ξενοδοχείο παραμένει merchant of record και η πληρωμή συλλέγεται για το ξενοδοχείο. Υπάρχουν ρυθμίσεις merchant-of-record για API ενσωματώσεις που χρειάζονται πραγματικά να λάβουν πληρωμή, με τις δικές τους απαιτήσεις αδειοδότησης.

Οι τέσσερις δυνατότητες που έχουν σημασία

Δυνατότητα	Τι σημαίνει	Γιατί τα προϊόντα σταματούν χωρίς αυτή
Ζωντανές τιμές και διαθεσιμότητα	Τρέχουσες τιμές και τι είναι πραγματικά διαθέσιμο για κράτηση, ανά εύρος ημερομηνιών	Οι αποθηκευμένες τιμές αποτυγχάνουν στην επιβεβαίωση και μειώνουν την εμπιστοσύνη
Δημιουργία κράτησης	Δημιουργία πραγματικής κράτησης που λαμβάνει το ξενοδοχείο	Χωρίς αυτή είστε απλώς σύνδεσμος παραπομπής, όχι προϊόν
Πληρωμή	Λήψη χρημάτων ως μέρος της κράτησης	Η παραπομπή σε άλλο ιστότοπο σκοτώνει τη μετατροπή
Επιβεβαίωση και webhooks	Ενημέρωση του επισκέπτη, του ξενοδοχείου και του συστήματός σας για το τι συνέβη	Διαφορετικά, υποστηρίζονται φόρτοι και κενά συμφωνίας

Τα περισσότερα “hotel APIs” που βρίσκει ένας προγραμματιστής καλύπτουν το πρώτο και μερικές φορές το δεύτερο. Η συναλλαγή είναι το δύσκολο μέρος και αυτό που καθορίζει αν έχετε προϊόν.

Την προσφορά ποίου ενσωματώνετε;

Αυτή η ερώτηση διαμορφώνει τα πάντα στη συνέχεια. Η προσφορά που μεταπωλείται μέσω αλυσίδας έρχεται με προσαύξηση μέσα στην τιμή, παλαιότερη διαθεσιμότητα και χωρίς δυνατότητα επαφής με το ξενοδοχείο για ερώτηση κράτησης. Η προσφορά που προέρχεται απευθείας από το ξενοδοχείο φέρει τη δική του τιμή, ζωντανή διαθεσιμότητα και ένα ξενοδοχείο που γνωρίζει ότι υπάρχει η κράτηση.

Για οτιδήποτε όπου ο ταξιδιώτης θα συγκρίνει με τον ίδιο τον ιστότοπο του ξενοδοχείου — που είναι τα περισσότερα — η προσφορά που ελέγχεται από το ξενοδοχείο αποφεύγει την άβολη στιγμή που η τιμή σας είναι χειρότερη.

Ποιος είναι ο merchant of record

Αν φτιάξετε μόνοι σας την κράτηση ξενοδοχείου, το να γίνετε merchant of record σημαίνει ανάληψη ευθύνης για πληρωμές, επιστροφές, φόρους και συχνά άδεια ταξιδιωτικού πρακτορείου σε κάθε αγορά.

Στο Wink το ξενοδοχείο παραμένει merchant of record και η πληρωμή συλλέγεται για το ξενοδοχείο, οπότε ο ενσωματωτής δεν κληρονομεί αυτή την ευθύνη. Υπάρχουν ρυθμίσεις merchant-of-record για API ενσωματώσεις όπου ο συνεργάτης χρειάζεται πραγματικά να λάβει την πληρωμή ο ίδιος, και αυτή η διαδρομή έχει τις δικές της απαιτήσεις αδειοδότησης.

Τρία επίπεδα ενσωμάτωσης

Web components. Ενσωματώστε μια αναζήτηση με δυνατότητα κράτησης, λίστα δωματίων ή checkout σε υπάρχουσα σελίδα. Χωρίς backend εργασία· λιγότερος έλεγχος στη διάταξη.
REST API. Πλήρης έλεγχος σε αναζήτηση, τιμές, δημιουργία κράτησης και επιβεβαίωση, με αυθεντικοποίηση OAuth2. Χρησιμοποιήστε το όταν η ροή κράτησης είναι μέρος της εμπειρίας του προϊόντος σας.
MCP server. Οι ίδιες δυνατότητες εκτίθενται για AI agents, ώστε ένας βοηθός να μπορεί να αναζητήσει, να τιμολογήσει και να ολοκληρώσει μια κράτηση αντί να παραπέμπει τον χρήστη σε ιστότοπο.

Τα τρία δεν είναι αποκλειστικά — ένα προϊόν συνήθως χρησιμοποιεί components για την προωθητική επιφάνεια και το API για τον βασικό του ροή.

Τι να φτιάξετε πρώτα

Αναζήτηση και τιμολόγηση για μία πόλη και ένα εύρος ημερομηνιών. Πάρτε πραγματικές τιμές πριν σχεδιάσετε οτιδήποτε.
Δημιουργήστε μία δοκιμαστική κράτηση από την αρχή μέχρι το τέλος, συμπεριλαμβανομένης της πληρωμής και της επιβεβαίωσης.
Εγγραφείτε στα booking.create και στα γεγονότα ακύρωσης πριν φτιάξετε οποιοδήποτε UI από πάνω.
Αποφασίστε νωρίς το μοντέλο απόδοσης ευθυνών — το πλαίσιο προέλευσης πρέπει να ταξιδεύει με την κράτηση, αλλιώς η αναφορά είναι εικασία αργότερα.
Διαχειριστείτε τις περιπτώσεις αποτυχίας: απώλεια διαθεσιμότητας μεταξύ προσφοράς και κράτησης, απόρριψη πληρωμής, μερικές επιστροφές.

Τιμές που πρέπει να γνωρίζει ένας προγραμματιστής

Τα Consumer και Booking Engine APIs είναι δωρεάν. Το Partner API περιλαμβάνει δωρεάν μηνιαίο όριο 10.000 διανυκτερεύσεων ξενοδοχείου, μετά χρεώνει ανά μονάδα. Οι επιβεβαιωμένες κρατήσεις φέρουν την προμήθεια πλατφόρμας του ξενοδοχείου 1,5% συν το κόστος επεξεργασίας κάρτας, και εφαρμόζεται προκαθορισμένη προμήθεια 10% όταν το προϊόν σας οδήγησε την κράτηση — που είναι ο τρόπος με τον οποίο ο ενσωματωτής κερδίζει αντί να πληρώνει.

Συνηθισμένα λάθη

Βασίζεστε σε αποθηκευμένες τιμές. Φαίνονται εντάξει στην ανάπτυξη αλλά αποτυγχάνουν στην παραγωγή.
Αφήνετε την πληρωμή σε ανακατεύθυνση. Κάθε παραπομπή χάνει κρατήσεις.
Αγνοείτε τα webhooks μέχρι το λανσάρισμα. Η συμφωνία γίνεται χειροκίνητη δουλειά.
Γίνεστε merchant of record χωρίς λόγο. Είναι απόφαση αδειοδότησης και ευθύνης, όχι μόνο τεχνική.
Δεν περνάτε το πλαίσιο προέλευσης. Η απόδοση δεν μπορεί να ανακατασκευαστεί μετά.

Πώς προσθέτουν οι προγραμματιστές κράτηση ξενοδοχείου σε ένα προϊόν;