Configurez votre plateforme de paiement premium
Les plateformes de paiement premium intégrées à Avantio permettent d’automatiser les encaissements liés à vos réservations et de traiter les transactions en toute sécurité.
La procédure de connexion varie selon le fournisseur. Dans certains cas, vous devrez d’abord créer un compte et compléter l’onboarding directement auprès de la plateforme. Dans d’autres, il sera nécessaire de demander certaines informations d’identification ou liens de connexion à l’équipe Customer Experience d’Avantio.
Dans cet article, vous trouverez le processus d’intégration de chaque fournisseur, les informations nécessaires et les délais d’activation indicatifs.
Que vas-tu apprendre dans cet article ?
Dans cet article, tu apprendras à :
Préparer les informations nécessaires avant de commencer une connexion.
Compléter l’onboarding avec le fournisseur de paiement.
Demander à Avantio les liens ou identifiants nécessaires.
Fournir correctement les identifiants d’intégration.
Vérifier la connexion via une réservation test.
Identifier les principales erreurs pendant le processus.
Avantages
Connecter une plateforme de paiement premium vous permettra :
D’automatiser les encaissements liés aux réservations.
De réduire l’intervention manuelle de l’équipe.
De centraliser la configuration des paiements.
De renforcer la sécurité grâce à des systèmes comme 3D Secure.
D’améliorer la traçabilité des transactions.
De faciliter le suivi des encaissements, remboursements et incidents.
D’adapter la solution de paiement au pays dans lequel opère votre entreprise.
Quand devez-vous effectuer cette configuration ?
Vous devez effectuer cette configuration lorsque :
Vous avez choisi la plateforme de paiement que votre entreprise va utiliser.
Vous avez confirmé que le fournisseur opère dans votre pays.
Vous souhaitez commencer à encaisser les réservations via la nouvelle plateforme.
Vous devez remplacer une passerelle utilisée précédemment.
Vous souhaitez automatiser des paiements que vous gérez actuellement manuellement.
Le fournisseur a validé le compte de votre entreprise.
Avant de commencer
Il est conseillé de vérifier au préalable :
Que la plateforme sélectionnée est disponible dans votre pays.
Que vous avez souscrit le service directement auprès du fournisseur.
Que le compte est enregistré au nom de la bonne entreprise.
Que vous avez complété les vérifications légales et bancaires demandées.
Que vous disposez d’un accès administrateur au compte.
Que vous avez préparé les informations et identifiants nécessaires.
Que vous savez quelle entreprise, quels bureaux ou quels logements utiliseront la connexion.
Que la personne responsable de la configuration dispose des droits suffisants sur Avantio.
Il est également recommandé de définir en interne qui sera chargé de vérifier les encaissements, les remboursements, les rapprochements et les éventuels incidents.
N’envoyez jamais d’identifiants sensibles via des canaux non autorisés. Si vous devez transmettre des informations à Avantio, faites-le via un ticket adressé à l’équipe Customer Experience.
Connectez votre plateforme premium choisie à Avantio
Comercia Global Payments
Comercia Global Payments
Avant de commencer
Pour utiliser Comercia Global Payments, vous devez d’abord lancer le processus de souscription et d’onboarding directement auprès de Comercia.
Suivez ces étapes
Contactez Comercia Global Payments via votre interlocuteur commercial.
Indiquez que vous souhaitez utiliser Comercia Global Payments avec Avantio.
Fournissez les documents d’entreprise et bancaires demandés.
Complétez le processus d’onboarding avec Comercia.
Attendez que Comercia valide et approuve le compte.
Comercia contactera Avantio pour transmettre les informations nécessaires à l’intégration.
Confirmez auprès de l’équipe Customer Experience d’Avantio que la demande est en cours.
Lorsque la connexion sera disponible, effectuez une réservation test.
Vérifiez que la transaction apparaît correctement dans Avantio et dans l’interface Comercia.
Délai d’activation
Le processus se termine généralement en une semaine environ, mais le délai peut varier selon les documents et validations nécessaires lors de l’onboarding.
Stripe
Stripe
Avant de commencer
Pour connecter Stripe, vous avez besoin de :
Un compte Stripe de type Standard.
Avoir complété le processus de vérification demandé par Stripe.
Un accès au compte avec les droits suffisants.
Un lien de connexion fourni par Avantio.
Suivez ces étapes
Accédez à la page Stripe et créez un compte de type Standard.
Complétez les informations d’entreprise, fiscales et bancaires demandées.
Finalisez le processus de vérification du compte.
Créez un ticket pour l’équipe Customer Experience d’Avantio.
Indiquez dans le ticket que vous souhaitez connecter votre compte Stripe Standard.
Attendez de recevoir le lien de connexion.
Ouvrez le lien et connectez-vous avec le compte Stripe concerné.
Autorisez la connexion entre Stripe et Avantio.
Confirmez auprès de l’équipe Customer Experience que le processus est terminé.
Effectuez une réservation test et vérifiez que le paiement est bien traité.
Délai d’activation
La connexion peut être active le jour même, à condition que le compte Stripe Standard soit vérifié et prêt à fonctionner.
SysPay
SysPay
Avant de commencer
Pour démarrer la connexion avec SysPay, vous devrez compléter leur processus d’onboarding.
Pendant ce processus, SysPay demandera deux identifiants qui doivent vous être fournis par Avantio :
Account ID.
Merchant ID.
Suivez ces étapes
Contactez l’équipe commerciale de SysPay.
Indiquez que vous souhaitez utiliser leur intégration avec Avantio.
Fournissez à SysPay les documents d’entreprise et bancaires requis.
Créez un ticket pour l’équipe Customer Experience d’Avantio.
Demandez votre Account ID et Merchant ID pour la connexion avec SysPay.
Transmettez ces deux identifiants à SysPay.
Complétez les vérifications restantes avec le fournisseur.
Attendez que SysPay active le module de traitement des paiements via API.
Quand SysPay confirme que le module est prêt, informez-en l’équipe Customer Experience d’Avantio via le ticket.
Avantio finalisera la configuration de l’intégration.
Effectuez une réservation test.
Vérifiez que la transaction est traitée et apparaît correctement sur les deux plateformes.
Délai d’activation
L’activation prend généralement quelques jours, selon le temps nécessaire pour compléter l’onboarding et activer le module de paiement via API.
Mercado Pago
Mercado Pago
Avant de commencer
Pour connecter Mercado Pago, vous avez besoin de :
Un compte entreprise actif.
Un accès à la section des intégrations.
Le User ID du compte.
La clé secrète configurée pour les webhooks.
L’Access Token de production.
L’URL de webhook fournie par Avantio.
Suivez ces étapes
Connectez-vous à votre compte entreprise Mercado Pago.
Accédez à la section Votre entreprise.
Sélectionnez Intégrations.
Trouvez le panneau des applications connectées.
Accédez à l’application que vous utiliserez pour la connexion avec Avantio.
Trouvez le champ User ID.
Copiez la valeur et conservez-la en lieu sûr.
Créez un ticket pour l’équipe Customer Experience d’Avantio.
Demandez l’URL à utiliser pour configurer les webhooks.
Retournez sur Mercado Pago et accédez à la section Webhooks.
Saisissez l’URL fournie par Avantio.
Dans la partie événements, sélectionnez Paiements.
Trouvez le champ Clé secrète.
Copiez la valeur correspondant à la clé secrète des webhooks.
Accédez à Identifiants de production.
Trouvez le champ Access Token.
Copiez la valeur et conservez-la en lieu sûr.
Vérifiez que vous disposez des informations suivantes :
User ID.
Webhooks Secret Key.
Access Token.
Transmettez ces informations à l’équipe Customer Experience d’Avantio via le ticket et le canal sécurisé indiqué.
Attendez qu’Avantio saisisse les identifiants dans l’assistant de connexion.
Lorsque la configuration est terminée, effectuez une réservation test.
Vérifiez que l’encaissement est bien traité et enregistré.
Délai d’activation
L’activation peut être immédiate dès qu’Avantio reçoit les bons identifiants et termine la configuration.
Après l’activation, il est nécessaire d’effectuer une réservation test pour vérifier que les encaissements fonctionnent correctement.
Tilopay
Tilopay
Avant de commencer
Pour connecter Tilopay, vous devez d'abord compléter leur processus d'onboarding et obtenir les identifiants de production.
Les informations nécessaires sont :
Tilopay Key.
Tilopay Password.
Tilopay Proxy Key.
Tilopay User.
Vous devrez également choisir le mode d'opération que vous utiliserez.
Modes d'opération disponibles
3DS v.2
Avec ce mode, le client devra autoriser via 3D Secure chacun des paiements liés à la réservation.
Ce mode peut convenir si vous souhaitez que chaque paiement nécessite une authentification individuelle du titulaire de la carte.
E-commerce : CIT et MIT
Avec ce mode, le client autorise via 3D Secure le premier paiement.
Les paiements suivants liés à la réservation peuvent être traités automatiquement comme des opérations initiées par le commerçant, à condition de respecter les conditions fixées par le prestataire.
Ce mode est adapté aux réservations avec plusieurs échéances ou paiements échelonnés.
Suivez ces étapes
Contactez directement Tilopay pour démarrer le processus d'onboarding.
Indiquez que vous utiliserez l'intégration avec Avantio.
Fournissez les documents d'entreprise et bancaires demandés.
Complétez les vérifications demandées par Tilopay.
Confirmez avec Tilopay quel mode d'opération convient le mieux à votre entreprise : 3DS v.2 ou E-commerce avec CIT et MIT.
Demandez les identifiants de production.
Vérifiez que vous disposez de la Tilopay Key, Tilopay Password, Tilopay Proxy Key et Tilopay User.
Créez un ticket pour l'équipe Customer Experience d'Avantio.
Transmettez les identifiants nécessaires via le canal sécurisé indiqué par l'équipe.
Indiquez le mode d'opération choisi.
Attendez qu'Avantio configure l'intégration.
Effectuez une réservation test.
Vérifiez le premier paiement et, le cas échéant, le fonctionnement des paiements suivants.
Délai d'activation
L'activation est généralement finalisée en quelques jours, selon le temps nécessaire pour terminer l'onboarding et obtenir les identifiants.
Ascent Payment Solutions
Ascent Payment Solutions
Avant de commencer
Pour connecter Ascent Payment Solutions, vous devez compléter leur processus d'onboarding et disposer des identifiants suivants :
Client ID.
Site ID.
Key.
Password.
Price ID.
Suivez ces étapes
Contactez directement Ascent Payment Solutions.
Indiquez que vous souhaitez utiliser l'intégration avec Avantio.
Complétez le processus de souscription et d'onboarding.
Fournissez les documents d'entreprise et bancaires demandés.
Attendez qu'Ascent approuve le compte et génère les identifiants.
Vérifiez que vous disposez du Client ID, Site ID, Key, Password et Price ID.
Créez un ticket pour l'équipe Customer Experience d'Avantio.
Transmettez les identifiants via le canal sécurisé indiqué.
Attendez qu'Avantio finalise la configuration.
Effectuez une réservation test.
Vérifiez que le paiement apparaît correctement à la fois dans Avantio et dans l'interface Ascent.
Délai d'activation
La connexion est généralement finalisée en quelques jours, selon l'avancement du processus d'onboarding avec Ascent.
Résultat attendu
Une fois le processus terminé auprès de votre prestataire :
La plateforme de paiement sera connectée à Avantio.
Vous pourrez traiter les paiements liés aux réservations.
Les transactions seront envoyées à la plateforme configurée.
Vous pourrez consulter les mouvements depuis Avantio et, si besoin, depuis le tableau de bord du prestataire.
Les paiements utiliseront les mesures de sécurité et d'authentification disponibles sur la plateforme.
L'intégration ne doit être considérée comme terminée qu'après avoir effectué et vérifié correctement une réservation test.
Étapes suivantes recommandées
Après avoir activé la connexion :
Effectuez une réservation test avec un montant réduit.
Vérifiez que le paiement est bien enregistré dans Avantio.
Assurez-vous que la transaction apparaît sur la plateforme de paiement.
Vérifiez le statut du paiement et la devise utilisée.
Testez le fonctionnement du 3D Secure.
Vérifiez les paiements suivants si vous travaillez avec des paiements échelonnés.
Effectuez un remboursement test si le prestataire le permet.
Confirmez quels membres de l'équipe ont accès au tableau de bord des paiements.
Documentez en interne la procédure de gestion des incidents et des rétrofacturations.
Informez l'équipe avant de commencer à traiter de vraies réservations.
Principales informations et identifiants
Selon le prestataire, vous pouvez avoir besoin des éléments suivants :
Stripe : compte Standard et lien de connexion.
Comercia Global Payments : compte approuvé et données gérées directement entre Comercia et Avantio.
Tilopay : Tilopay Key, Tilopay Password, Tilopay Proxy Key et Tilopay User.
Ascent Payment Solutions : Client ID, Site ID, Key, Password et Price ID.
SysPay : Account ID et Merchant ID.
Mercado Pago : User ID, Webhooks Secret Key et Access Token.
Considérez toujours ces identifiants comme des informations confidentielles.
Limitations et points à prendre en compte
Veuillez noter que :
Avantio ne peut pas finaliser l'intégration tant que le prestataire n'a pas validé le compte.
Les délais d'activation sont donnés à titre indicatif.
La documentation demandée dépend du prestataire et du pays.
Les identifiants doivent être ceux de l'environnement de production, sauf indication contraire.
Un identifiant incomplet, expiré ou mal copié peut empêcher la connexion.
L'intégration peut nécessiter l'intervention du prestataire et d'Avantio.
Certaines opérations doivent être gérées depuis le tableau de bord externe de la plateforme.
L'activation technique ne garantit pas que tous les moyens de paiement soient activés.
La configuration du 3D Secure peut varier selon la plateforme et le mode d'opération.
Les paiements suivants peuvent nécessiter une configuration spécifique.
Vous ne devez pas commencer à traiter de vrais paiements sans avoir effectué un test.
Avant de changer une plateforme déjà utilisée, vérifiez l'impact sur les réservations existantes et les paiements encore en attente.
Bonnes pratiques
Utilisez un compte professionnel et non un compte personnel.
Complétez l'onboarding avant de demander l'activation sur Avantio.
Vérifiez soigneusement chaque identifiant avant de l'envoyer.
Ne partagez pas de mots de passe ou de tokens sur des canaux non autorisés.
Gardez à jour le contact administratif de la plateforme.
Limitez les accès aux personnes qui ont réellement besoin de gérer les paiements.
Activez l'authentification à deux facteurs sur le tableau de bord du prestataire si disponible.
Effectuez toujours une réservation test.
Vérifiez à la fois le premier paiement et les paiements suivants.
Contrôlez régulièrement les transactions refusées.
Documentez en interne le processus de remboursement et de rétrofacturation.
Informez Avantio et le prestataire si vous modifiez le compte bancaire, l'entité légale ou les identifiants.
Évitez de remplacer une connexion active pendant les périodes avec un volume important de paiements en attente.
Cas pratique
Une entreprise décide d'utiliser Tilopay pour gérer des réservations avec plusieurs paiements.
L'entreprise complète l'onboarding et choisit le mode E-commerce avec CIT et MIT, car elle souhaite que le client autorise le premier paiement via 3D Secure et que les paiements suivants soient traités automatiquement.
Après avoir reçu les identifiants de production, l'entreprise transmet à Avantio la Tilopay Key, Tilopay Password, Tilopay Proxy Key et Tilopay User.
Avantio finalise la configuration et l'entreprise effectue une réservation test avec deux échéances. Elle vérifie d'abord l'authentification du paiement initial puis s'assure que le second paiement est traité selon la configuration convenue.
Ce n'est qu'après avoir validé les deux paiements que l'entreprise commence à utiliser l'intégration pour des réservations réelles.
Erreurs fréquentes
La connexion ne peut pas être activée
Vérifiez que le compte a bien été entièrement validé par le fournisseur et que toutes les vérifications en attente ont été finalisées.
Les identifiants ne sont pas valides
Assurez-vous d’avoir copié l’intégralité des valeurs, sans espaces supplémentaires, sauts de ligne ou caractères manquants.
Vérifiez également qu’il s’agit bien d’identifiants de production et non d’un environnement de test.
Le paiement n’apparaît pas sur la plateforme
Vérifiez que la réservation utilise la bonne plateforme et que la transaction a bien été envoyée.
Contrôlez aussi le statut du paiement et les éventuels messages d’erreur.
3D Secure ne s’affiche pas
L’authentification peut dépendre du type de carte, du pays, de l’émetteur et de la configuration de la plateforme.
Vérifiez auprès du fournisseur que 3D Secure est bien activé sur le compte.
Les paiements ultérieurs ne sont pas traités
Vérifiez que la plateforme et le mode d’opération permettent d’effectuer des prélèvements ultérieurs.
Sur Tilopay, vérifiez si le mode E-commerce avec CIT et MIT a été configuré lorsque c’est nécessaire.
Mercado Pago ne reçoit pas les notifications
Vérifiez que :
L’URL du webhook est correcte.
L’événement Paiements est bien sélectionné.
La clé secrète est valide.
Les identifiants de production sont actifs.
SysPay ne termine pas l’activation
Vérifiez que SysPay a bien reçu l’Account ID et le Merchant ID corrects.
Quand SysPay active le module API, prévenez Avantio pour que nous puissions finaliser l’intégration.
Si quelque chose ne fonctionne pas
Si l’intégration ne fonctionne pas comme prévu, vérifiez ces points avant de contacter l’équipe Customer Experience :
Assurez-vous que le compte est validé et actif.
Vérifiez qu’il n’y a pas de validations en attente auprès du fournisseur.
Contrôlez que les identifiants sont corrects et complets.
Vérifiez que vous utilisez bien des identifiants de production.
Assurez-vous que le fournisseur a activé l’intégration ou le module API.
Vérifiez que la bonne plateforme est associée à la configuration des paiements.
Contrôlez le statut de la transaction dans Avantio et sur le tableau de bord du fournisseur.
Actualisez la page et vérifiez à nouveau le résultat.
Effectuez une nouvelle réservation test si nécessaire.
Si le problème persiste, ouvrez un ticket et indiquez :
Nom de l’entreprise.
Plateforme de paiement utilisée.
Date et heure approximatives de l’opération.
Identifiant de la réservation.
Montant et devise.
Statut du paiement.
Message d’erreur complet.
Captures d’écran.
Confirmation que l’onboarding est terminé.
N’incluez pas de mots de passe, de tokens complets ou d’autres identifiants sensibles dans les captures d’écran.
Questions fréquentes
Dois-je souscrire à la plateforme avant de la connecter à Avantio ?
Dois-je souscrire à la plateforme avant de la connecter à Avantio ?
Oui. Vous devez créer ou souscrire le compte directement auprès du fournisseur et compléter le processus d’onboarding et de vérification correspondant.
Avantio intervient dans la connexion technique, mais ne remplace pas le contrat entre votre entreprise et la plateforme de paiement.
Combien de temps prend l’activation ?
Combien de temps prend l’activation ?
Le délai dépend de chaque fournisseur :
Stripe peut être activé le jour même si le compte Standard est déjà prêt.
Comercia Global Payments peut nécessiter environ une semaine.
Tilopay, Ascent et SysPay demandent généralement plusieurs jours.
Mercado Pago peut être activé immédiatement après réception et configuration des bons identifiants.
Ces délais sont donnés à titre indicatif et peuvent varier.
Puis-je envoyer les identifiants par e-mail ?
Puis-je envoyer les identifiants par e-mail ?
Utilisez toujours le canal sécurisé indiqué par l’équipe Customer Experience.
Ne partagez pas de mots de passe, tokens ou clés sensibles via des canaux non autorisés.
Est-il obligatoire de faire une réservation test ?
Est-il obligatoire de faire une réservation test ?
Oui, c’est fortement recommandé.
La réservation test permet de vérifier que la plateforme est bien connectée, que le paiement est correctement enregistré et que l’authentification fonctionne avant de traiter des réservations réelles.
Qui configure la connexion ?
Qui configure la connexion ?
Cela dépend de la plateforme.
Dans certains cas, Avantio fournit un lien ou configure les identifiants. Dans d’autres, le fournisseur doit d’abord activer un module ou contacter directement Avantio.
Puis-je changer de plateforme de paiement ?
Puis-je changer de plateforme de paiement ?
Oui, mais il faut d’abord vérifier les paiements en attente et les réservations existantes.
Ne désactivez pas l’ancienne plateforme avant de savoir comment seront gérés les paiements qui n’ont pas encore été traités.
Que dois-je faire si je modifie un identifiant ?
Que dois-je faire si je modifie un identifiant ?
Contactez l’équipe Customer Experience d’Avantio pour mettre à jour la configuration.
Un identifiant modifié ou révoqué peut interrompre le traitement des paiements.
Puis-je utiliser plusieurs plateformes en même temps ?
Puis-je utiliser plusieurs plateformes en même temps ?
La disponibilité de cette option dépendra de la configuration de votre compte, de la structure de votre entreprise et de l’usage prévu.
Contactez l’équipe Customer Experience pour que nous puissions étudier votre cas.