Les quatre capacités essentielles
Section intitulée « Les quatre capacités essentielles »| Capacité | Ce que cela signifie | Pourquoi les produits bloquent sans cela |
|---|---|---|
| Tarifs et disponibilités en temps réel | Prix actuels et ce qui est réellement réservable, par plage de dates | Les tarifs mis en cache échouent à la confirmation et minent la confiance |
| Création de réservation | Créer une vraie réservation que l’hôtel reçoit | Sans cela, vous êtes un lien de renvoi, pas un produit |
| Paiement | Encaisser l’argent dans le cadre de la réservation | Un transfert vers un autre site fait mourir la conversion |
| Confirmation et webhooks | Informer le client, l’hôtel et votre système de ce qui s’est passé | Sinon, charge de support et écarts de réconciliation |
La plupart des « APIs hôtelières » que trouve un développeur couvrent la première et parfois la deuxième. La transaction est la partie difficile, et c’est elle qui détermine si vous avez un produit.
De quel fournisseur intégrez-vous l’offre ?
Section intitulée « De quel fournisseur intégrez-vous l’offre ? »Cette question conditionne tout ce qui suit. Une offre revendue via une chaîne arrive avec une majoration dans le tarif, une disponibilité plus périmée, et pas de lien direct vers l’hôtel pour une question sur la réservation. Une offre provenant directement de l’hôtel porte le tarif propre de l’hôtel, la disponibilité en temps réel, et un hôtel qui sait que la réservation existe.
Pour tout ce où le voyageur comparera avec le site propre de l’hôtel — ce qui est la plupart des cas — une offre contrôlée par l’hôtel évite le moment gênant où votre prix est moins avantageux.
Qui est le marchand de référence
Section intitulée « Qui est le marchand de référence »Si vous construisez la réservation d’hôtel vous-même, devenir marchand de référence signifie assumer la responsabilité du paiement, des rétrofacturations, des remboursements, de la gestion fiscale et souvent une licence d’agence de voyage dans chaque marché.
Sur Wink, l’hôtel reste marchand de référence et le paiement est collecté pour l’hôtel, donc un intégrateur n’hérite pas de cette responsabilité. Des arrangements marchand de référence sont disponibles sur les intégrations API où un partenaire doit réellement encaisser lui-même, et cette voie implique ses propres exigences de licence.
Trois niveaux d’intégration
Section intitulée « Trois niveaux d’intégration »- Composants web. Intégrez une recherche réservable, une liste de chambres ou un paiement dans une page existante. Pas de travail backend ; contrôle minimal sur la mise en page.
- API REST. Contrôle total sur la recherche, les tarifs, la création de réservation et la confirmation, authentifié avec OAuth2. À utiliser lorsque le parcours de réservation fait partie de l’expérience propre de votre produit.
- Serveur MCP. Les mêmes capacités exposées aux agents IA, pour qu’un assistant puisse rechercher, tarifer et finaliser une réservation au lieu de rediriger l’utilisateur vers un site web.
Les trois ne sont pas exclusifs — un produit utilise souvent des composants pour une surface marketing et l’API pour son flux principal.
Par quoi commencer
Section intitulée « Par quoi commencer »- Recherchez et tarifez pour une ville et une plage de dates. Obtenez des tarifs réels avant de concevoir quoi que ce soit.
- Créez une réservation test complète, incluant paiement et confirmation.
- Abonnez-vous à
booking.createet aux événements d’annulation avant de construire une interface utilisateur. - Décidez tôt de votre modèle d’attribution — le contexte source doit voyager avec la réservation, sinon vos rapports seront approximatifs.
- Gérez les cas d’échec : disponibilité perdue entre devis et réservation, paiement refusé, remboursements partiels.
Tarification à connaître pour un développeur
Section intitulée « Tarification à connaître pour un développeur »Les APIs Consumer et Booking Engine sont gratuites. L’API Partner inclut une allocation mensuelle gratuite de 10 000 nuitées hôtelières, puis facture à l’unité. Les réservations confirmées supportent la commission plateforme de 1,5 % de l’hôtel plus les frais de traitement carte au coût, et une commission par défaut de 10 % s’applique lorsque votre produit a généré la réservation — c’est ainsi qu’un intégrateur gagne plutôt que paie.
Erreurs courantes
Section intitulée « Erreurs courantes »- Construire sur des tarifs mis en cache. Ils semblent corrects en développement mais échouent en production.
- Laisser le paiement à une redirection. Chaque transfert fait perdre des réservations.
- Ignorer les webhooks jusqu’au lancement. La réconciliation devient un travail manuel.
- Devenir marchand de référence sans nécessité. C’est une décision de licence et de responsabilité, pas seulement technique.
- Ne pas transmettre le contexte source. L’attribution ne peut pas être reconstituée après coup.