Qui touche l'argent

Le loyer va au compte Localoge que désigne le host_ref du logement, c’est-à-dire à l’utilisateur qui vous a autorisé. Vous n’avez rien à faire pour cela : voir Connecter un hôte.

Reste une question qui ne vous concerne qu’à la marge : cet hôte perçoit-il lui-même, ou est-ce le propriétaire du bien ? Elle se règle logement par logement, et c’est l’hôte qui choisit. Deux valeurs :

payout_model	L’argent va
host (défaut)	Au titulaire du compte Localoge, c’est-à-dire vous, ou votre utilisateur.
owner	Au propriétaire du bien, directement, sur un compte rattaché au logement.

Pourquoi ce réglage existe

Une conciergerie qui n’a ni carte professionnelle ni garantie financière n’a pas le droit d’encaisser les loyers de ses propriétaires : en France, c’est un exercice illégal de la profession d’agent immobilier. owner permet à ces gestionnaires de travailler normalement, les loyers allant au propriétaire sans jamais transiter par eux.

À l’inverse, une conciergerie qui en a le droit garde host et reverse elle-même. Le choix vous appartient, ou plutôt il appartient à votre utilisateur : Localoge ne vérifie pas votre statut et n’a pas à en décider.

En pratique

Poussez payout_model avec le logement :

{ "external_property_id": "PROP-4821", "title": "…", "payout_model": "owner" }

Puis demandez-nous le lien d’invitation de ce logement. Vous le transmettez au propriétaire par votre propre canal ; il ouvre son compte de paiement en quelques minutes.

Nous ne vous demanderons jamais la liste de vos propriétaires

Cette liste est votre fonds de commerce. Le lien est opaque et nominatif à un logement, vous seul savez à qui vous l’envoyez, et nous n’apprenons l’existence d’un propriétaire qu’au moment où il ouvre lui-même son compte. Aucun champ e-mail de propriétaire n’existe dans cette API, et c’est délibéré.

En owner, le logement n’est pas réservable avant l’activation

Tant que le propriétaire n’a pas terminé son inscription, les réservations sont refusées sur ce logement. Nous ne basculons pas silencieusement le versement vers votre compte : ce serait exactement l’infraction que le réglage sert à éviter.

Prévoyez donc l’invitation avant de mettre le logement en vente, et non après.

Changer d’avis

Le réglage se modifie, mais pas quand un séjour est en cours. Nous lisons le compte destinataire environ cinq jours avant l’arrivée : basculer entre-temps enverrait au propriétaire l’argent d’un séjour vendu sous l’autre régime. L’API répond alors 409 et vous dit combien de séjours sont concernés.

Si vous ne poussez pas payout_model, nous ne touchons à rien. Un partenaire qui ignore ce champ ne ramènera donc jamais un logement à host par inadvertance.