Démo en ligne

API de réservation de croisières

API de croisières pour agences : départs, cabines et échéanciers de paiement

Une API de croisières permet à votre site d'afficher les départs en temps réel, de tarifer les catégories de cabines et de créer des réservations auprès de la compagnie. Cette page explique à quoi ressemblent les données, comment fonctionnent cabines et paiements, et les deux façons de proposer des croisières sur votre propre site PHPTRAVELS.

  • Départs et itinéraires
  • Catégories de cabines et plans de pont
  • Acomptes et solde
  • Intégrations croisières sur mesure

Ce que renvoie une API de croisières

Un départ, décrit en données

Une croisière se vend comme un départ : un navire, un itinéraire, une date. Toute API de croisières, quel que soit son format, est construite autour de cette unité.

Une recherche envoie une région, un mois ou une période, une durée et le nombre de passagers. La réponse est une liste de départs, chacun avec le navire, la compagnie, les dates d'embarquement et de retour, les escales avec leurs horaires, les jours en mer et un prix d'appel par personne pour chaque catégorie de cabine encore ouverte.

Ensuite, d'autres appels tarifent la catégorie choisie pour les vrais passagers, listent les cabines sélectionnables, créent la réservation et encaissent les paiements. Les noms et formats varient selon les compagnies : la plateforme ramène donc chaque source au même modèle de départ, de cabine et de réservation avant que le client ne voie quoi que ce soit.

Compagnie

Votre compagnie partenaire

Navire partenaire · 7 nuits

Ouvert
Embarquement
2027-05-15
Retour
2027-05-22

Itinéraire

  1. D1Southampton--:-- · 17:00
  2. D2En mer
  3. D3Bruges (Zeebrugge)08:00 · 18:00
  4. D4Amsterdam09:00 · 19:00
  5. D5En mer
  6. D6Copenhague07:00 · 17:00
  7. D7Oslo09:00 · 16:00
  8. D8Southampton07:00 · --:--
Prix d'appelpar personne, base doubleEUR 899

Enregistrement illustratif, qui n'est le format d'aucune compagnie en particulier.

Une plateforme de réservation de croisières qui reçoit départs, catégories de cabines et prix du système d'une compagnie

Catégories de cabines

Quatre échelons à bord : intérieure, vue mer, balcon, suite

Sous chaque départ, une API de croisières liste des catégories de cabines. Elles déterminent l'essentiel du prix, et chacune fait varier plusieurs choses à la fois.

  1. 01IntérieureSans fenêtre

    Le prix d'entrée du départ. Les compagnies la scindent souvent en plusieurs catégories selon le pont et l'emplacement, chacune avec son code.

    Niveau de prix
  2. 02Vue merFenêtre ou hublot

    Un cran au-dessus pour la lumière du jour. Certaines catégories ont une vue partiellement obstruée, ce que l'API signale dans la description de la catégorie.

    Niveau de prix
  3. 03BalconBalcon privatif

    Un espace extérieur privé, avec des catégories qui varient selon la hauteur du pont et l'emplacement au milieu ou à l'arrière.

    Niveau de prix
  4. 04SuiteBalcon et salon

    Le haut de la grille tarifaire, souvent avec des extras inclus dans le tarif, et les catégories les plus susceptibles d'être vendues comme cabine précise.

    Niveau de prix

Codes de catégorie et codes tarifaires

Chaque catégorie a un code, et chaque départ peut être vendu sous plusieurs codes tarifaires : tarifs standard, promotionnels, groupes ou agences. La même cabine peut avoir des prix et des conditions différents selon le code tarifaire.

Garantie ou cabine précise

Avec une réservation garantie, le client achète une catégorie et la compagnie attribue la cabine plus tard, dans cette catégorie ou une supérieure. La réservation de cabine précise fixe le numéro de cabine dès la réservation. Beaucoup de compagnies tarifent les deux différemment.

Choix de la cabine

Choisissez la cabine sur le plan du pont

Lorsqu'une compagnie autorise la réservation d'une cabine précise, l'API renvoie les cabines encore disponibles dans la catégorie choisie, avec le pont, l'emplacement et le nombre de passagers que chacune accueille.

Pont 9

Sélectionnez une cabine

AvantArrière
0814
242636
29
011119
  • Intérieure
  • Vue mer
  • Balcon
  • Suite
  • Indisponible

Cabine 9110

Intérieure

Cabine intérieure, le prix le plus bas sur ce pont. Vendue comme cabine précise ou en garantie.

Vue mer

Cabine avec fenêtre à l'avant, là où la coque s'incurve. L'API renvoie la note sur la vue avec la catégorie.

Balcon

Cabine avec balcon au milieu du navire. L'emplacement sur le pont forme souvent une catégorie distincte avec son propre prix.

Suite

Suite orientée vers l'arrière avec un balcon plus grand. En général réservée comme cabine précise, pas en garantie.

  1. 1.Lister les cabinesUne fois la catégorie choisie, la plateforme demande à la compagnie les cabines libres et les dessine sur le pont.
  2. 2.Bloquer la cabineBeaucoup d'API de croisières permettent de bloquer brièvement la cabine choisie pendant que le client saisit les noms et paie.
  3. 3.RéserverLa réservation confirme le numéro de cabine, les passagers et le code tarifaire, et la compagnie renvoie sa référence de dossier.

Dans le Croisières de PHPTRAVELS, les navires portent leurs ponts et leurs catégories de cabines et les clients choisissent en connaissance de cause, que les cabines soient les vôtres ou celles d'une compagnie connectée.

Échéancier de paiement

Acompte maintenant, le solde avant l'appareillage

Les croisières se réservent des mois à l'avance et se paient en plusieurs fois. La compagnie fixe les dates et les montants pour chaque départ et chaque tarif, et l'API les renvoie avec la réservation.

  1. 01

    Réservation et acompte

    Le client verse un acompte fixé par la compagnie, par personne ou par dossier, pour confirmer la cabine.

  2. 02

    Solde à payer

    Le solde est dû à une date fixée par la compagnie avant le départ. Les dossiers impayés peuvent être annulés par la compagnie passé ce délai.

  3. 03

    Documents

    Une fois le paiement complet reçu, la compagnie délivre les documents de croisière et le client renseigne ses informations d'enregistrement.

  4. 04

    Jour du départ

    Le client embarque. Les modifications à partir de là se traitent à bord ou selon les règles de la compagnie.

Frais d'annulation par période

Période de l'acompteLes frais augmententFrais maximaux

Plus le départ approche, plus la part du tarif retenue à l'annulation est élevée. Les périodes et les pourcentages dépendent de chaque compagnie et de chaque tarif : une API de croisières les envoie avec la réservation et votre plateforme les montre au client avant le paiement.

Lorsque vous vendez des départs que vous avez contractés vous-même, le Croisières fonctionne de la même façon : vous fixez l'acompte et la date du solde par départ, et les soldes en attente sont suivis dans l'administration jusqu'à leur règlement.

Tarification des croisières

Comment se construit le prix d'une croisière

Les prix de croisière se lisent autrement que ceux d'un hôtel ou d'un vol. Une API de croisières renvoie les éléments séparément, et votre moteur de réservation doit les assembler comme le fait la compagnie.

Par-dessus le prix de la compagnie, PHPTRAVELS applique vos marges et commissions par navire, départ ou canal, et les agents du Portail de voyage B2B voient leurs propres tarifs nets.

  • Par personne, pas par cabine

    Les tarifs de croisière sont donnés par passager. Une cabine pour deux coûte le double du tarif par personne, et l'API tarifie chaque passager selon son âge et sa place dans la cabine.

  • Sur la base d'une occupation double

    Les prix d'appel supposent deux passagers par cabine. Les troisième et quatrième passagers paient en général un tarif réduit, et le voyageur seul règle un supplément single.

  • Taxes, frais et redevances portuaires

    Les taxes gouvernementales, les frais et les redevances portuaires s'ajoutent par personne au tarif de la croisière. Affichez-les sur des lignes distinctes pour que le total n'ait aucune surprise.

  • Crédit à bord et extras

    Certains tarifs incluent un crédit à bord, un forfait boissons ou les pourboires. L'API les renvoie comme inclusions du tarif, et c'est l'une des raisons pour lesquelles deux tarifs pour une même cabine diffèrent.

Comment obtenir des croisières

Vos propres contrats ou l'API d'une compagnie

Il y a deux voies pour proposer des croisières sur votre site. Beaucoup d'agences commencent par la première et ajoutent la seconde quand le volume le justifie.

Prêt dans le module Croisières

Chargez vos propres contrats de croisière

Saisissez dans l'administration les départs que vous contractez : navires, ponts, catégories de cabines, itinéraires escale par escale, dates de départ, tarifs par personne, saisons, acomptes et dates de solde. Les partenaires croisières peuvent recevoir un accès fournisseur pour tenir leurs départs à jour.

  • Espaces groupe et allotements que vous détenez
  • Commission par compagnie
  • Tarifs nets pour les agents B2B
  • Opérationnel dès le jour de l'installation
Intégration sur mesure

Connectez l'API d'une compagnie ou d'un consolidateur

La liste d'intégrations de PHPTRAVELS ne comporte pas de connecteur croisières prêt à l'emploi. Comme chaque offre inclut le code source complet, l'API d'une compagnie ou d'un consolidateur de croisières se connecte sous forme de Intégration d'API sur mesure, mappée sur les mêmes départs, cabines et réservations que le module affiche déjà.

  • Vous signez avec la compagnie ou le consolidateur
  • Vous recevez et conservez les identifiants de l'API
  • Le connecteur mappe départs, catégories et cabines
  • Réservations, paiements et annulations suivent les règles de la compagnie

Vous cherchez des fournisseurs ? La Liste des fournisseurs XML API voyage recense les compagnies de croisière qui distribuent par API, et Qu'est-ce que l'intégration d'API explique comment se construit une connexion de ce type.

Voyez le parcours de réservation de croisière en action

Ouvrez la démo en ligne pour rechercher des départs, comparer les catégories de cabines et réserver avec un acompte, puis comparez les offres sur Tarifs.

FAQ

Questions sur l'API de croisières

Parler à un conseiller

Une API de croisières est un ensemble de services web qu'une compagnie ou un consolidateur de croisières ouvre aux vendeurs de voyages. Votre système l'utilise pour rechercher des départs, lire les itinéraires, tarifer les catégories de cabines, lister les cabines disponibles, créer des réservations et encaisser acomptes et soldes.

Non. Le module Croisières est construit autour d'un stock que vous gérez vous-même : navires, catégories de cabines et départs que vous contractez. La connexion à une compagnie ou un consolidateur précis est développée comme une intégration sur mesure à partir du code source inclus.

Vous faites une demande auprès de la compagnie ou d'un consolidateur de croisières en tant que vendeur de voyages. Les conditions d'accès varient selon la compagnie et le marché. Vous signez le contrat et recevez vous-même les identifiants ; PHPTRAVELS ne fournit jamais d'identifiants fournisseur.

Une réservation garantie sécurise une catégorie de cabine à un prix défini, et la compagnie attribue la cabine réelle plus tard, dans cette catégorie ou une supérieure. La réservation de cabine précise fixe le numéro de cabine dès la réservation.

La compagnie les fixe par départ et par tarif, et son API les renvoie avec la réservation. Pour les départs que vous saisissez vous-même, vous définissez l'acompte et la date d'échéance du solde pour chaque départ dans l'administration.

Les tarifs de croisière sont donnés par passager, généralement sur la base de deux personnes par cabine. Les troisième et quatrième passagers paient leur propre tarif, le voyageur seul règle un supplément single, et taxes, frais et redevances portuaires s'ajoutent par personne.

Oui. Les agents réservent dans le portail B2B avec leurs propres tarifs nets et commissions, et paient depuis leur portefeuille d'agent, sur la même installation que votre site public.

L'offre Enterprise inclut la REST API et les webhooks de PHPTRAVELS avec leur documentation, et chaque offre inclut le code source complet : vos développeurs peuvent donc étendre le moteur de réservation de croisières ou le relier à d'autres systèmes.

Commencez par les départs que vous contractez déjà, chargés dans le module Croisières, et voyez comment ils se vendent. Lorsqu'un partenariat avec une compagnie ou le volume le justifie, ajoutez l'API de cette compagnie par une intégration sur mesure.