API partenaires
Connectez votre plateforme à Vivestay
Pour les logiciels de gestion locative, les plateformes d’hébergement et les partenaires d’intégration qui travaillent avec des clients Vivestay. Votre plateforme continue de gérer la réservation ; Vivestay se charge de l’enregistrement du voyageur — et prévient votre plateforme quand c’est fait.
Ce que votre plateforme peut faire
De la réservation au voyageur enregistré
-
Créer des enregistrements depuis les réservations
Envoyez une réservation à Vivestay : elle devient un enregistrement voyageur pour le bon logement, identifié par votre propre référence de réservation.
-
Émettre le lien voyageur
Recevez un lien d’enregistrement sécurisé pour le voyageur à la création de l’enregistrement, et émettez-en un nouveau chaque fois que c’est nécessaire.
-
Garder les réservations à jour
Transmettez les changements de dates, d’heure d’arrivée ou de nombre de voyageurs. Un enregistrement déjà complété par le voyageur n’est jamais écrasé.
-
Savoir où en est chaque dossier
Consultez n’importe quel enregistrement par votre référence de réservation pour voir son statut et savoir si tout ce qui est requis a été fourni.
-
Être prévenu quand un voyageur termine
Vivestay prévient votre plateforme lorsqu’un voyageur termine son enregistrement. Les notifications sont signées pour que vous puissiez les vérifier, réessayées si votre plateforme est brièvement indisponible, et consignées pour que chaque livraison puisse être revue.
-
Suivre la déclaration aux autorités
Lorsque le client déclare les séjours aux autorités via Vivestay, votre plateforme peut voir où en est chaque déclaration.
Flux d’informations
Ce qui entre, ce qui revient
-
Ce que votre plateforme envoie
Votre référence de réservation, le logement Vivestay, les dates d’arrivée et de départ et — lorsque vous les avez — l’heure d’arrivée, le nombre de voyageurs ainsi que le nom et les coordonnées du titulaire de la réservation.
-
Ce que Vivestay renvoie
Le statut de l’enregistrement, si ses exigences sont remplies et, sur demande, le lien voyageur sécurisé.
-
L’identité reste du côté du voyageur
Les voyageurs transmettent leurs données d’identité directement à Vivestay, via leur propre lien sécurisé. Votre plateforme n’a jamais à collecter de passeports ni de pièces d’identité.
-
Une réservation, un enregistrement
Chaque référence de réservation correspond à un seul enregistrement : envoyer deux fois la même réservation ne crée jamais de doublon.
Intégrations types
Comment les partenaires l’utilisent
-
Le lien d’enregistrement dès la réservation
Un logiciel de gestion locative crée l’enregistrement dès qu’une réservation est confirmée et ajoute le lien voyageur à ses propres messages de réservation.
-
Le statut d’enregistrement à côté de chaque arrivée
Une plateforme d’hébergement affiche les arrivées déjà enregistrées, mises à jour dès qu’un voyageur termine.
-
Une vérification avant le jour d’arrivée
Un partenaire d’intégration passe en revue les séjours à venir et relance les enregistrements encore ouverts.
Connectez votre logiciel de réservation
Des connexions prêtes à l’emploi, sans développement
Les clients Vivestay peuvent aussi connecter leur logiciel de réservation directement dans Vivestay, sans aucun travail d’intégration.
-
OwnerRez
Réservations, modifications et annulations arrivent automatiquement depuis OwnerRez dès que le client connecte son compte.
-
Calendriers iCal
Tout calendrier qui publie un flux iCal peut être synchronisé, pour que ses réservations apparaissent dans Vivestay.
Accès et prérequis
L’API partenaires agit pour le compte d’un client Vivestay. L’administrateur du client donne à votre plateforme son propre accès depuis la console Vivestay, limité au travail d’intégration, et peut le révoquer à tout moment. Il n’y a pas d’inscription développeur séparée.
Les logements du client sont configurés dans Vivestay, et les réservations y sont rattachées ; l’API partenaires ne crée pas de logements à partir des réservations. La déclaration aux autorités reste une action du client lui-même dans Vivestay.
La documentation technique d’intégration est disponible pour les partenaires d’intégration : contactez-nous et choisissez « Partenariat ou intégration ».
Vous préparez une intégration ?
Parlez-nous de votre plateforme et des clients que vous servez : nous vous transmettrons la documentation technique et vous aiderons à vous connecter.