Configurer des passerelles de paiement personnalisées et les paiements par Carte cadeau dans le moteur de réservation Plus

Objectif Configurer une passerelle de paiement personnalisée ou un flux de travail de carte cadeau dans Booking Engine Plus et comprendre la mise en œuvre prise en charge ainsi que le parcours d’assistance.
Idéal pour Les administrateurs PMS, les gestionnaires d’établissement, les propriétaires, ainsi que les développeurs web ou partenaires d’intégration travaillant sur un flux de paiement personnalisé.
À utiliser lorsque Tu souhaites enregistrer une option de paiement personnalisée via Booking Engine Plus, prendre en charge l’entrée de carte cadeau avec des champs personnalisés, tester une passerelle tierce ou comprendre ce qui est pris en charge avec l’Expérience Immersive.
Prérequis Booking Engine Plus, Virement bancaire activé pour le moteur de réservation, accès à l’onglet Personnaliser du moteur de réservation, et un développeur web expérimenté ou un partenaire d’intégration pour le JavaScript personnalisé. Les flux de travail de carte cadeau nécessitent également un champ client personnalisé.
Résultat attendu L’option de paiement personnalisée est enregistrée via le système d’événements du moteur de réservation, apparaît lors du check-out hébergé, et la logique personnalisée du fournisseur peut rediriger le client pour finaliser le paiement après la création de la réservation.
Limites Une seule passerelle de paiement personnalisée peut être configurée. Les modes de paiement personnalisés sont pris en charge uniquement dans le moteur de réservation hébergé, pas dans l’Expérience Immersive complète. Cloudbeds ne développe ni ne maintient la logique des passerelles personnalisées.

Introduction

Cloudbeds Booking Engine Plus peut prendre en charge une passerelle de paiement personnalisée ou un flux de travail de carte cadeau via un JavaScript personnalisé. L’option de paiement personnalisée utilise le EventSystem du moteur de réservation et l’option de paiement Virement bancaire comme base pour le flux personnalisé.

Le moteur de réservation hébergé reste l’environnement de check-out pris en charge pour les méthodes de paiement personnalisées. Cet article explique les exigences de configuration, ce avec quoi l’Assistance Cloudbeds peut aider, ce qui reste sous la responsabilité du fournisseur de paiement ou du développeur, et comment utiliser les intégrations premium lorsqu’un établissement souhaite une expérience d’entrée sur le site web plus immersive.

Table des matières

Qui est concerné et comment

Les flux de paiement personnalisés impliquent à la fois la configuration Cloudbeds et le développement tiers. Utilise ce tableau pour identifier quelle partie du processus te concerne.

Rôle Ce qu’il faut savoir
Administrateur PMS ou gestionnaire d’établissement Active le paramètre de paiement requis du moteur de réservation, ajoute le code fourni par le prestataire dans l’onglet Personnaliser, et complète la configuration de test prise en charge. Consulte Exigences et limites du support avant de mettre en œuvre le script.
Développeur web ou fournisseur de passerelle de paiement Crée, maintient et dépanne le JavaScript personnalisé, la redirection de la passerelle et la logique côté prestataire. Pour des questions d’intégration plus poussées, le fournisseur de paiement doit collaborer avec l’équipe Intégrations Cloudbeds. Consulte Tester et dépanner une passerelle de paiement personnalisée.
Propriétaire ou directeur général Utilise le moteur de réservation hébergé pour le check-out avec paiement personnalisé. Si tu souhaites une expérience d’entrée sur le site web plus marquée par la marque, consulte l’approche prise en charge avec intégrations premium dans Utiliser des méthodes de paiement personnalisées avec l’expérience immersive.

Exigences et limites du support

Avant de mettre en œuvre une passerelle de paiement personnalisée ou un flux de travail de carte cadeau, confirme les paramètres requis du moteur de réservation et qui est responsable de chaque partie de la mise en œuvre.

  • Active le Virement bancaire comme option de paiement pour le moteur de réservation dans Cloudbeds PMS.
  • Utilise du JavaScript personnalisé avec l’EventSystem du moteur de réservation pour enregistrer l’option de paiement personnalisée.
  • Une seule passerelle de paiement personnalisée peut être intégrée. L’établissement ne peut pas proposer le Virement bancaire et une passerelle de paiement personnalisée comme options séparées en même temps.
  • Le support des cartes cadeaux nécessite un champ client personnalisé pour que le client saisisse le numéro de la carte cadeau.
  • Les méthodes de paiement personnalisées sont prises en charge uniquement dans les environnements hébergés du moteur de réservation. Elles ne sont pas prises en charge dans l’expérience immersive complète Cloudbeds Booking Engine Immersive Experience 2.0.
  • Les étapes de mise en œuvre de cet article s’appliquent uniquement à Booking Engine Plus.

 Cloudbeds ne développe ni ne maintient les passerelles de paiement personnalisées. La création, la modification ou le dépannage de la logique des passerelles personnalisées ne relève pas du support Cloudbeds ni de Cloudbeds Payments. Ton développeur web, le fournisseur de la passerelle de paiement, le revendeur ou le partenaire d’intégration doit être responsable du code personnalisé et du comportement côté fournisseur.

Comment l’assistance Cloudbeds peut t’aider

L’assistance Cloudbeds peut aider à la configuration côté Cloudbeds nécessaire pour que ton fournisseur teste sa mise en œuvre. Le support peut :

  • Te guider pour créer un plan tarifaire test avec un code promo afin que le fournisseur de paiement puisse examiner la console du navigateur. Utilise un tarif personnalisé de 0,50 USD et rends ce plan tarifaire test disponible uniquement pour la source moteur de réservation.
  • T’aider à ajouter les scripts personnalisés fournis par ton fournisseur de passerelle de paiement dans le panneau Personnaliser du moteur de réservation.

Pour un dépannage avancé ou des questions d’intégration, le fournisseur de la passerelle de paiement doit travailler directement avec l’équipe d’intégrations Cloudbeds. Si le fournisseur n’est pas encore partenaire Cloudbeds, invite-le à postuler via la page Devenir partenaire Cloudbeds.

Utiliser des méthodes de paiement personnalisées avec l’expérience immersive

Les méthodes de paiement personnalisées ne sont pas prises en charge dans le Cloudbeds Booking Engine Immersive Experience 2.0 complet. Si tu souhaites conserver le début du parcours de réservation sur le site web de ton établissement, utilise les intégrations premium comme point d’entrée et complète la réservation sur le moteur de réservation hébergé.

Tu peux utiliser des intégrations premium telles que les widgets multi-établissements, sélecteur de date et sélecteur d’hébergement sur ton site web. Les clients peuvent interagir avec l’expérience widget prise en charge sur ton site, puis continuer vers le moteur de réservation hébergé par Cloudbeds pour finaliser la réservation et utiliser la redirection de paiement personnalisée.

 Limitation actuelle : Les clients ne peuvent pas consulter nativement les résultats complets de recherche du moteur de réservation sur le site de l’établissement avant d’être redirigés vers la page hébergée pour la réservation et le paiement.

Configurer une passerelle de paiement tierce ou un workflow de carte cadeau

L’option de paiement personnalisée doit être enregistrée via le EventSystem du moteur de réservation. La configuration ci-dessous couvre l’enregistrement de l’événement côté Cloudbeds ainsi que l’événement de création de réservation utilisé par la logique de redirection du fournisseur.

Étape 1 : Ajouter le JavaScript personnalisé dans l’onglet Personnaliser

  1. Ouvre le Menu Compte Menu Compte.jpg et va dans Paramètres > Moteur de réservation.
  2. Clique sur Personnaliser.
  3. Ajoute le JavaScript personnalisé dans le champ JavaScript.
  4. Clique sur Enregistrer.

Le JavaScript personnalisé doit s’abonner à l’événement on-booking-engine-ready. Cet événement est déclenché lorsque le moteur de réservation est prêt à émettre et écouter des événements. Le script doit aussi déclencher l’événement custom-payment-option-change afin que le moteur de réservation puisse enregistrer l’option de paiement personnalisée.

<script>
window.addEventListener('on-booking-engine-ready', (e) => {
  const { eventSystem } = e.detail;

  eventSystem.dispatchEvent("custom-payment-option-change", {
    id: "%PAYMENT_OPTION_ID%",
    instructions: "Ton texte par défaut pour les instructions va ici.",
    name: "Ton texte par défaut pour le libellé va ici.",
  });
});
</script>

 Lorsque tu enregistres les modifications dans le champ JavaScript, Cloudbeds peut te demander de compléter une authentification multifacteur renforcée (MFA). Consulte Authentification multifacteur renforcée pour les champs HTML et JavaScript personnalisés du moteur de réservation pour le déroulement de la vérification.

Étape 2 : Enregistrer l’option de paiement personnalisée avec EventSystem

Utilise eventSystem.dispatchEvent() pour déclencher l’événement custom-payment-option-change avec les détails requis de l’option de paiement :

  • id [string] : Obligatoire. La valeur doit avoir une longueur supérieure à 0 et être valide pour une utilisation comme identifiant CSS. N’utilise pas d’espaces, de points-virgules ou de caractères spéciaux invalides dans les sélecteurs CSS. Le format suggéré est kebab-case. Remplace %PAYMENT_OPTION_ID% par l’identifiant de la passerelle de paiement personnalisée.
  • instructions [string] : Facultatif. Affiche des instructions ou une description lorsque le client développe l’option de paiement personnalisée. Utilise cette valeur comme texte par défaut lorsque le texte spécifique à la langue n’est pas personnalisé via CSS.
  • name [string] : Obligatoire. La valeur doit avoir une longueur supérieure à 0.

 Si la charge utile de l’événement ne respecte pas les conditions requises, l’option de paiement personnalisée ne sera pas enregistrée et l’option Virement bancaire continuera d’être affichée.

Après avoir enregistré les modifications, ouvre le moteur de réservation hébergé et teste le check-out. L’étape de paiement peut s’ouvrir dans une fenêtre contextuelle ou une fenêtre modale séparée au lieu d’apparaître en ligne sur la page de réservation. L’option de paiement personnalisée doit toujours être enregistrée via le système d’événements du moteur de réservation.

La visuelle suivante montre la fenêtre de paiement hébergée avec les modes de paiement disponibles après que le client a poursuivi le check-out.

Cloudbeds Booking Engine hosted checkout showing a separate Payment window with Credit Card and Bank Transfer options

Étape 3 : Gérer l’événement reservation-created et la redirection vers le fournisseur

Lorsqu’un client effectue une réservation en utilisant l’option de paiement personnalisée, la réservation est créée dans Cloudbeds PMS avec un mode de paiement e-banking et aucun paiement n’est collecté par Cloudbeds. Le script personnalisé du fournisseur peut écouter l’événement reservation-created, utiliser les données de réservation et rediriger le client vers la passerelle de paiement tierce pour finaliser le paiement.

eventSystem.addEventListener('reservation-created', (data) = {
  // Ton code à exécuter après la création d’une réservation...
})

Utilise le système d’événements du moteur de réservation pour les événements d’enregistrement et reservation-created. Ne te fie pas uniquement aux écouteurs de clic spécifiques à la page, aux clics sur les boutons accordéon ou aux sélecteurs d’interface utilisateur pour déterminer si l’option de paiement personnalisée a été sélectionnée.

Développe les sections de référence avancée ci-dessous si tu as besoin de détails optionnels sur le libellé, les instructions, l’icône ou les données de réservation.

Personnalisation facultative du libellé, des instructions et de l’icône

Tu peux spécifier un texte basé sur la langue pour le libellé personnalisé de l’option de paiement :

html[lang="%LANG%"] [data-id="%PAYMENT_OPTION_ID%-name"]::before {
  content: "Ton texte spécifique à la langue pour le libellé va ici.";
}

Tu peux aussi configurer des instructions basées sur la langue :

html[lang="%LANG%"] [data-id="%PAYMENT_OPTION_ID%-instructions"]::before {
  content: "Ton texte spécifique à la langue pour les instructions va ici.";
}

Tu peux masquer l’icône par défaut et ajouter un logo ou une icône personnalisée :

// Pour masquer l’icône SVG par défaut
[data-id="%PAYMENT_OPTION_ID%-icon"] svg {
  display: none;
}

// Pour personnaliser l’icône en la définissant comme image de fond
[data-id="%PAYMENT_OPTION_ID%-icon"] {
  background-image: url(PAYMENT_OPTION_ICON_URL);
  background-size: cover;
  background-position: center;
  width: 40px;
  height: 40px;
}

Référence des données de l’événement reservation-created

Les données exposées par l’événement reservation-created ont la structure suivante :

interface CreatedReservation {
  booking_id?: `${number}`;
  booking_total?: number;
  checkin_date?: string;
  checkout_date?: string;
  city?: string;
  currency_code?: string;
  hotel_name?: string;
  real_booking_total?: number;
  resRooms?: {
    adults: `${number}`;
    id: `${number}`;
    kids: `${number}`;
    package: `${number}`;
    package_name: string | null;
    rate_id: `${number}`;
    room_total: `${number}`;
    room_type_id: `${number}`;
    room_type_name: string;
    room_type_photos: ({
      TYPE?: string;
      alt: string;
      cropParam: string | null;
      croppedImage: string;
      fullPath: string;
      galleryPath?: string | null;
      id: string;
      imageHeight: string;
      imageWidth: string;
      mime?: string;
      originalName: string;
      ownerId?: string;
      ownerType?: string;
      parentId: string;
      path: string;
      section?: string;
      size?: string;
      thumbPath: string;
      uploadedAt?: string;
      utype?: string;
    } & {
      featured: number;
      featuredPath: string | null;
    })[];
  }[];
  rooms?: Record<string, {="{" adults:="adults:" number;="number;" amount:="amount:" bookedid:="bookedId:" string[];="string[];" kids:="kids:" name:="name:" string;="string;" packageid?:="packageId?:" packagename?:="packageName?:" picture?:="picture?:" price?:="price?:" rateid:="rateId:" roomid:="roomId:" unit?:="unit?:" }="}">;
  state?: string;
  total_tax?: number;
  widget_property?: number;
};</string,>

Tester et dépanner une passerelle de paiement personnalisée

Utilise un flux de test contrôlé du moteur de réservation lorsque ton fournisseur de paiement doit inspecter le comportement de la console du navigateur ou valider sa logique de redirection. L’Assistance Cloudbeds peut aider avec la configuration du test côté Cloudbeds, mais le fournisseur de paiement reste responsable du code de la passerelle personnalisée et du dépannage côté fournisseur.

Créer un plan tarifaire de test pour le dépannage fournisseur

L’assistance Cloudbeds peut te guider pour créer un plan tarifaire temporaire avec un code promo à des fins de test. Utilise un tarif personnalisé de 0,50 USD et rends le plan tarifaire disponible uniquement pour la source moteur de réservation afin que ton fournisseur de paiement puisse reproduire le processus de check-out et examiner la console du navigateur.

Déploie le problème qui correspond au comportement que tu observes.

L’option de paiement personnalisée ne s’affiche pas

Vérifie les points suivants :

  • Confirme que le Virement bancaire est activé pour le moteur de réservation dans Cloudbeds PMS.
  • Confirme que le JavaScript personnalisé est ajouté dans l’onglet Personnaliser du moteur de réservation.
  • Confirme que la charge utile de l’événement custom-payment-option-change inclut un id et un name valides.
  • Confirme que l’id ne contient pas d’espaces, de points-virgules ou de caractères invalides pour un sélecteur CSS.
  • Confirme qu’une seule passerelle de paiement personnalisée est configurée.

Si la charge utile de l’événement ne remplit pas toutes les conditions, l’option de paiement personnalisée ne sera pas enregistrée et le Virement bancaire continuera de s’afficher.

La redirection du paiement personnalisé ne fonctionne pas

Vérifie les points suivants :

  • Confirme que le script personnalisé écoute l’événement reservation-created.
  • Confirme que le script ne dépend pas uniquement des écouteurs de clic spécifiques à une page, des clics sur les boutons accordéon ou des sélecteurs d’interface utilisateur.
  • Confirme que l’URL de la passerelle de paiement tierce et les paramètres de redirection sont valides.

Si la redirection échoue toujours après confirmation de la configuration côté Cloudbeds, le fournisseur de la passerelle de paiement ou le développeur doit résoudre les problèmes liés à la logique personnalisée. Pour des questions d’intégration plus poussées, le fournisseur doit travailler directement avec l’équipe des intégrations Cloudbeds. Si le fournisseur n’est pas encore partenaire Cloudbeds, invite-le à postuler via la page Devenir partenaire Cloudbeds.


Maintenant que tu comprends la configuration prise en charge pour le paiement personnalisé et les limites de propriété, consulte ces ressources pour découvrir les capacités plus larges du moteur de réservation Plus et la configuration prise en charge de l’expérience immersive :

Cet article vous a-t-il été utile ?
Utilisateurs qui ont trouvé cela utile : 0 sur 0

Commentaires

0 commentaire

Vous devez vous connecter pour laisser un commentaire.