Aller au contenu
Blog

API de réservation hôtel et vol : un voyage, deux réservations

Rédaction Tekravel
Rédigé avec l’aide de l’IA

Le ticket dit : « ajouter les hôtels au parcours vol, un seul paiement, un seul total ». Demande raisonnable de la part d'un chef de produit, qui semble tenir en une journée, puisque la recherche de vols existe et la page de paiement aussi. Trois semaines plus tard, l'équipe débat de ce qui doit se passer quand la compagnie confirme et que l'hôtel ne confirme pas. Une API de réservation hôtel et vol n'est pas une intégration avec deux types de résultats. Ce sont deux intégrations qui partagent un panier.

Plus tôt le code l'admet, moins il y a de réécriture. Voici ce que les guides d'intégration omettent : en quoi les deux moitiés diffèrent, laquelle engager en premier, et ce qu'un voyage doit être dans votre modèle de données.

Les deux moitiés ne se comportent pas pareil

Toutes deux reviennent en JSON avec un prix et une référence, elles se ressemblent donc sur le fil. Elles ne se ressemblent pas dans ce qu'elles vous promettent une fois la référence en main.

QuestionVolHôtel
Ce que vous détenez après la réservationUne réservation (PNR) qui n'est pas encore un billetUne confirmation qui est en général déjà ce que vous avez vendu
Durée de validité du prixJusqu'au retarification du tarif à la réservation, qui peut différer de la rechercheJusqu'à l'expiration du tarif, et un tarif peut changer entre la disponibilité et la réservation
Ce qui confirmeL'émission du billet, souvent avant une limite de tempsLa confirmation du fournisseur, parfois immédiate, parfois en attente
Comment l'annulerUn void si c'est tôt, sinon un remboursement selon les règles tarifaires, souvent avec pénalitéUne annulation selon la politique du tarif, gratuite jusqu'à une échéance sur de nombreux tarifs
Ce qui change le montant tardivementTarif, taxes, parfois la devise du tarifTaxes et frais payés sur place, formule de repas, chambre réellement attribuée

On peut contester une ligne, car les fournisseurs diffèrent, mais pas la forme : une moitié a une étape d'émission et l'autre une fenêtre d'annulation, et elles ne coïncident pas dans le temps. Nous avons traité le côté vol de la séquence dans intégration d'API de réservation de vols et le problème des fournisseurs lents côté hôtel dans API de disponibilité hôtelière : conception du client. Cet article commence où ils s'arrêtent, à la jointure.

Que réserver d'abord ?

Personne ne vous dit que c'est une décision de conception, et c'est elle qui fixe le coût d'un échec.

Un client achète un vol et un hôtel pour les mêmes dates. Vous envoyez une réservation, puis l'autre. Trois issues : les deux réussissent, l'une échoue, ou l'une échoue après que l'autre a réussi. La première est une bonne journée. Les deux autres décident de votre file de support.

Si vous émettez le billet d'abord et que l'hôtel refuse, vous avez un client avec un siège vers une ville sans chambre, déjà débité, et un remboursement sur un billet qui porte une pénalité. Si vous réservez l'hôtel d'abord et que le vol échoue, vous détenez une chambre souvent annulable gratuitement : la réparation est peu coûteuse. Le risque inverse existe aussi, car un tarif non annulable est le pire à détenir ; lisez donc les conditions d'annulation du tarif avant de le laisser partir en premier.

C'est une règle empirique, pas une loi, et l'enjeu est de choisir l'ordre en connaissance de cause. Engagez la moitié la plus facile à défaire avant la plus difficile, vérifiez le prix des deux côtés juste avant qu'aucune ne s'engage, et écrivez ce que vous faites dans chacune des trois issues. Les relecteurs le demandent rarement. Les clients s'en aperçoivent toujours.

Un voyage, deux réservations

La forme qui tient est un enregistrement de voyage qui possède deux réservations, chacune avec sa référence, son statut et ses conditions. Le client voit un total. Votre base voit deux lignes, et le total est une somme que vous calculez, pas une chose qui existe chez le fournisseur.

Gardez les deux statuts séparés. « Confirmé » pour l'hôtel et « émis » pour le vol ne sont pas le même état, et une colonne de statut unique qui les aplatit finira par dire « réservé » sur un voyage à moitié réservé.

Gardez aussi séparées les conditions de modification, et affichez-les. Un total affiché cache que changer les dates est une modification gratuite sur une moitié et un frais sur l'autre. Si votre interface propose « changer les dates » comme un seul bouton, décidez de ce qu'il fait quand une seule moitié peut bouger, avant qu'un client ne le découvre pour vous. Il en va de même pour la marge : si vous ajoutez la vôtre par service, comme la plupart des vendeurs, le total du voyage compte deux marges, et un remboursement sur une moitié doit savoir laquelle il restitue. L'argent est là où un voyage joint coûte cher, car les lignes se règlent à des échéances différentes, et le remboursement du vol n'arrive pas quand l'annulation de l'hôtel prend effet.

Où se situe cette plateforme

Sans détour : la plateforme expose des API vols et hôtels, et l'accès commence par une conversation plutôt que par une clé en libre-service. Les services sont activés par locataire, de sorte qu'un locataire qui vend des hôtels et pas de circuits ne porte pas la surface circuits. Rien ici ne promet un appel unique réservant les deux moitiés de façon atomique, et vous ne devez pas concevoir comme s'il existait. Traitez-les comme les deux réservations qu'elles sont, sous un voyage que vous possédez.

Pour voir les appels et conditions réels avant de construire autour, partez de la page des API de voyage et apportez l'ordre dans lequel vous comptez réserver. Si vous cherchez encore ce que l'accès gratuit vous apporte, API de réservation d'hôtel gratuite expose les sortes de gratuit.

Ce que coûte une erreur

La version coûteuse est la silencieuse. Un client est émis vers une ville et la chambre a disparu, et la première nouvelle est un message en pleine nuit, depuis un aéroport. Moins coûteux mais réel : un paiement qui affiche un total rassurant puis, après vérification du prix, un second chiffre que le client n'a pas accepté ; un remboursement qui rend le vol et oublie l'hôtel ; et un statut « réservé » quand le fournisseur dit autre chose.

Rien de cela n'exige une solution astucieuse. Il faut que le voyage soit un objet réel, que l'ordre soit une décision consignée, et que les deux prix soient revérifiés au dernier moment avant qu'aucune réservation ne s'engage. Construisez cela une fois, et le paiement pourra paraître aussi simple que le demandait le ticket.

Rédaction Tekravel

Desk technologies du voyage

Le desk technologies du voyage de Tekravel écrit pour les professionnels : dirigeants d'agences, consolidateurs et développeurs qui les intègrent. Chaque article est vérifié sur la plateforme qu'il décrit avant publication.