Configurez votre passerelle de paiement
Avantio permet de connecter différentes passerelles de paiement pour automatiser les encaissements liés aux réservations.
Le processus d'intégration dépend de chaque fournisseur. Certaines plateformes nécessitent des configurations spécifiques de la part de votre banque, tandis que d'autres demandent des identifiants de production, la tokenisation, des webhooks ou un site web opérationnel pour finaliser les tests.
Avant de commencer le processus technique, vous devez vérifier la compatibilité, formaliser le contrat correspondant et compléter l'onboarding demandé par le fournisseur.
Que vas-tu apprendre dans cet article ?
Dans cet article, tu apprendras à :
Préparer les informations nécessaires avant de lancer la connexion.
Demander les activations requises à ta banque ou à ton fournisseur.
Identifier les identifiants nécessaires pour chaque plateforme.
Configurer les webhooks et la tokenisation.
Finaliser la connexion avec l'aide d'Avantio.
Effectuer les tests nécessaires avant de traiter de vrais paiements.
Résoudre les erreurs les plus courantes lors de l'intégration.
Avantages
Connecter une passerelle de paiement avec Avantio te permettra :
D'automatiser les encaissements des réservations.
De réduire les opérations manuelles.
D'appliquer des systèmes d'authentification comme le 3D Secure.
De centraliser la configuration des paiements.
D'améliorer la traçabilité des transactions.
De réaliser des préautorisations lorsque la plateforme le permet.
De traiter des paiements ultérieurs selon la configuration souscrite.
De recevoir des notifications de paiement en temps réel.
De faciliter la gestion des remboursements et des incidents.
Quand faut-il effectuer cette configuration ?
Tu devrais lancer cette configuration lorsque :
Tu as choisi la plateforme de paiement.
Tu as confirmé qu'elle fonctionne dans ton pays.
Tu connais les coûts associés.
Le fournisseur a validé le compte de ton entreprise.
Tu disposes des identifiants de production.
Ta banque a effectué les activations nécessaires.
Tu souhaites remplacer une connexion précédente.
Tu as besoin d'automatiser les encaissements depuis Avantio.
Avant de commencer
Il est conseillé de vérifier au préalable :
Que l'entreprise est enregistrée dans un pays compatible.
Que tu as bien signé le contrat avec le fournisseur.
Que le processus d'onboarding est terminé.
Que tu as un accès administrateur au compte.
Que les identifiants correspondent à l'environnement de production.
Que ton TPE est compatible avec les protocoles requis.
Que tu as un site web opérationnel si nécessaire.
Que tu as défini qui gérera les tests.
Que tu connais les moyens de paiement que tu utiliseras.
Que tu as confirmé si tu as besoin de préautorisations ou de tokenisation.
Il est aussi recommandé de coordonner l'activation avec l'équipe responsable des réservations, des paiements et de la réconciliation.
Ne partage jamais d'identifiants sensibles via des canaux non autorisés. Transmets les informations demandées via un ticket adressé à l'équipe Customer Experience.
Connecte ta plateforme choisie avec Avantio
Redsys via Worldline
Redsys via Worldline
L'intégration permet de connecter un TPE Redsys avec Avantio Payments en utilisant le connecteur fourni par Worldline.
Avant de commencer
Contacte l'équipe Customer Experience d'Avantio pour vérifier que ta banque et ton TPE sont compatibles.
Actuellement, cette intégration n'est pas disponible avec Banco Sabadell.
Une fois la compatibilité confirmée, Avantio te fournira le contrat correspondant.
Demande les activations à ta banque
Après avoir signé le contrat, demande à ta banque les configurations suivantes :
Activation du protocole SIS REST PSPS.
Association du commerce Redsys à PSP OGONE SIS REST CON MPI EXTERNO.
Activation des opérations MIT.
Activation des opérations MOTO.
Activation du 3D Secure v2.
Activation des préautorisations.
Les opérations MOTO sont nécessaires pour certaines transactions liées aux portails.
Les préautorisations permettent de faire des retenues et des libérations de montants, par exemple pour gérer des cautions.
Configuration supplémentaire pour BBVA
Si la banque acquéreuse est BBVA, tu dois aussi demander l'activation du protocole CVC optionnel.
Si ta banque a besoin d'informations techniques supplémentaires, elle peut contacter Avantio à l'adresse suivante :
Données nécessaires
Une fois que la banque a confirmé les activations, crée un ticket pour l'équipe Customer Experience et transmets :
Merchant ID ou FUC.
Code MCC ou catégorie du commerce.
Numéro de terminal.
Moyens de paiement disponibles.
Acquirer BIN de Visa.
Acquirer BIN de Mastercard.
Indique aussi si le TPE accepte d'autres moyens de paiement, comme American Express.
Suis ces étapes
Contacte l'équipe Customer Experience d'Avantio.
Demande la vérification de compatibilité de ta banque.
Confirme que ta banque peut travailler avec le protocole requis.
Relis et signe le contrat fourni par Avantio.
Demande à la banque l'activation du protocole SIS REST PSPS.
Demande l'association du commerce à PSP OGONE SIS REST CON MPI EXTERNO.
Demande l'activation de MIT et MOTO.
Demande l'activation du 3D Secure v2.
Demande l'activation des préautorisations si tu gères des cautions.
Si tu travailles avec BBVA, demande le CVC optionnel.
Attends que la banque confirme toutes les activations.
Rassemble le Merchant ID, le MCC, le numéro de terminal et l'Acquirer BIN.
Transmets les données à Avantio via un ticket.
Attends la finalisation de la configuration technique.
Effectue une réservation test.
Vérifie le bon fonctionnement du paiement.
Teste les opérations ultérieures ou les préautorisations si besoin.
Délai estimé d'activation
Le processus peut prendre de quelques jours à plusieurs semaines.
Le délai dépend de :
La rapidité de réponse de la banque.
La configuration préalable du TPE.
L'activation du protocole requis.
La validation des identifiants techniques.
L'activation finale de la plateforme.
Axerve
Axerve
Avant de commencer
Contacte Axerve pour formaliser le contrat et demander l'ouverture du compte.
Lorsque tu contactes le fournisseur, demande aussi le service de Tokenization si tu as besoin d'utiliser des cartes tokenisées pour des paiements ultérieurs.
Une fois le contrat validé, Axerve te donnera accès à son intranet ou backoffice.
Identifiants nécessaires
Depuis le tableau de bord Axerve, tu dois obtenir :
ShopLogin.
ApiKey.
Tu devras également configurer une URL de webhook pour recevoir les notifications de paiement.
Configure le webhook
Le webhook permet à Axerve d'informer Avantio en temps réel des changements de statut des transactions.
Demande l'URL à Avantio
Crée un ticket pour l'équipe Customer Experience.
Indique que tu es en train de configurer Axerve.
Demande l'URL de webhook correspondant à ton compte.
Conserve l'URL exactement telle qu'elle t'est fournie.
Ajoute l'URL dans Axerve
Connecte-toi au tableau de bord Axerve.
Va dans Configurazione.
Sélectionne Ambiente.
Trouve le champ Url server to server.
Colle l'URL fournie par Avantio.
Enregistre la configuration.
Ne modifie pas l'URL et n'ajoute pas d'espaces supplémentaires.
Suis ces étapes
Contacte Axerve.
Indique que tu utiliseras l'intégration avec Avantio.
Formalise le contrat.
Demande le service de tokenisation si besoin.
Finalise les vérifications du compte.
Accède au backoffice Axerve.
Trouve le ShopLogin.
Récupère l'ApiKey.
Crée un ticket pour l'équipe Customer Experience.
Demande l'URL du webhook.
Va dans Configurazione → Ambiente → Url server to server.
Renseigne l'URL fournie.
Enregistre la configuration.
Transmets à Avantio le ShopLogin et l'ApiKey.
Attends la finalisation de l'intégration.
Effectue une réservation test.
Vérifie qu'Axerve envoie bien les notifications de paiement.
Assure-toi que le statut de la transaction se met à jour dans Avantio.
Délai estimé d'activation
La connexion peut être finalisée le jour même dès qu'Avantio reçoit et valide les données transmises par Axerve.
Le délai peut être rallongé si :
Le contrat n'est pas encore validé.
La tokenisation n'est pas activée.
Les identifiants sont incorrects.
Le webhook n'est pas configuré.
Le compte n'est pas activé pour fonctionner en production.
Amazon Payment Services
Amazon Payment Services
Avant de commencer
Contactez Amazon Payment Services pour formaliser le contrat et démarrer le processus d’onboarding.
Au cours de ce processus, indiquez clairement que vous avez besoin d’utiliser la tokenisation.
La tokenisation est nécessaire pour stocker de façon sécurisée une référence de la carte et effectuer les opérations autorisées par la plateforme sans conserver directement les données sensibles.
Identifiants nécessaires
Pour activer la connexion, vous aurez besoin de :
MerchantId.
AccessCode.
ShaRequest.
ShaResponse.
Les identifiants doivent correspondre à l’environnement de production, sauf si des données spécifiques sont demandées pour effectuer des tests.
Suivez ces étapes
Contactez Amazon Payment Services.
Confirmez que la plateforme est disponible dans votre pays.
Indiquez que vous utiliserez l’intégration avec Avantio.
Formalisez le contrat.
Complétez la documentation d’onboarding.
Demandez l’activation de la tokenisation.
Attendez l’approbation du compte par Amazon Payment Services.
Demandez les identifiants d’intégration.
Vérifiez que vous disposez du MerchantId, AccessCode, ShaRequest et ShaResponse.
Créez un ticket pour l’équipe Customer Experience d’Avantio.
Transmettez les identifiants via le canal sécurisé indiqué.
Attendez qu’Avantio termine la configuration.
Effectuez une réservation test.
Réalisez l’authentification 3D Secure.
Vérifiez que la transaction apparaît correctement.
Vérifiez le fonctionnement de la tokenisation si nécessaire.
Attention aux détails
Tous les paiements traités via cette passerelle utiliseront 3D Secure par défaut.
Vérifiez que le parcours de réservation permet à l’hôte de compléter correctement l’authentification.
Délai estimé d’activation
L’activation prend généralement plusieurs jours.
Le délai dépend principalement de la finalisation de l’onboarding, de l’activation de la tokenisation et de la remise des identifiants.
PowerTranz
PowerTranz
PowerTranz est la version de FAC compatible avec 3D Secure v2.
Elle remplace l’ancienne intégration FAC, qui ne prenait en charge que 3D Secure v1.
Avant de commencer
Pour finaliser l’intégration, vous devez disposer d’un site web opérationnel.
Le site web sera utilisé pour effectuer des tests :
Dans l’environnement de test.
Dans l’environnement réel ou de production.
Confirmez auprès de PowerTranz que votre compte et votre marché sont compatibles avec la version prenant en charge 3D Secure v2.
Identifiants nécessaires
Demandez à PowerTranz :
PowerTranzId.
PowerTranzPassword.
Les identifiants doivent correspondre à l’environnement indiqué pour chaque phase de test.
Suivez ces étapes
Contactez PowerTranz pour démarrer le processus d’onboarding.
Indiquez que vous utiliserez l’intégration avec Avantio.
Confirmez que vous souscrirez à la version compatible avec 3D Secure v2.
Fournissez à PowerTranz la documentation requise.
Préparez un site web opérationnel.
Demandez les identifiants de l’environnement de test.
Obtenez le PowerTranzId et le PowerTranzPassword.
Créez un ticket pour l’équipe Customer Experience d’Avantio.
Transmettez les identifiants via le canal sécurisé indiqué.
Coordonnez avec Avantio les tests dans l’environnement de test.
Vérifiez que le processus d’authentification fonctionne correctement.
Finalisez avec PowerTranz l’activation de l’environnement de production.
Fournissez les identifiants définitifs si différents.
Effectuez un test dans l’environnement réel.
Vérifiez que le paiement apparaît à la fois dans Avantio et dans PowerTranz.
Confirmez avec Avantio que l’intégration peut être utilisée.
Résultat attendu
À la fin du processus :
PowerTranz sera connecté à Avantio.
Les paiements utiliseront 3D Secure v2.
Vous pourrez traiter des cartes dans les devises acceptées.
Les transactions seront enregistrées sur le tableau de bord du prestataire.
Le site web sera prêt à compléter le parcours d’authentification.
Résultat attendu
Une fois la connexion de la plateforme sélectionnée finalisée :
La passerelle sera reliée à Avantio.
Vous pourrez traiter les paiements des réservations.
Les encaissements utiliseront l’authentification disponible.
Les transactions seront envoyées au prestataire concerné.
Les changements de statut seront mis à jour via le mécanisme configuré.
Vous pourrez effectuer les opérations autorisées par votre contrat.
Les paiements ultérieurs ou préautorisations fonctionneront lorsqu’ils sont activés.
Ne considérez pas l’intégration comme terminée tant qu’une réservation test n’a pas été réalisée avec succès.
Prochaines étapes recommandées
Après avoir activé la plateforme :
Effectuez une réservation test avec un montant réduit.
Vérifiez que le paiement apparaît dans Avantio.
Vérifiez que l’opération apparaît sur le tableau de bord du prestataire.
Confirmez que le montant et la devise sont corrects.
Vérifiez le fonctionnement du 3D Secure.
Vérifiez les notifications du webhook si nécessaire.
Testez la tokenisation si vous l’avez souscrite.
Vérifiez les paiements ultérieurs.
Testez une préautorisation si la plateforme le permet.
Vérifiez la procédure de remboursement.
Confirmez les droits des utilisateurs internes.
Documentez la procédure de gestion des incidents.
Informez votre équipe avant de commencer à traiter des paiements réels.
Principales informations et options
Selon la plateforme, vous aurez besoin de :
Redsys via Worldline : Merchant ID ou FUC, MCC, numéro de terminal, moyens de paiement et Acquirer BIN.
PowerTranz : PowerTranzId et PowerTranzPassword.
Amazon Payment Services : MerchantId, AccessCode, ShaRequest et ShaResponse.
Axerve : ShopLogin, ApiKey et URL du webhook.
Vous pouvez également avoir besoin de :
Activation du MIT.
Activation du MOTO.
Configuration du 3D Secure v2.
Activation des préautorisations.
Tokenisation.
Site web opérationnel.
Identifiants de test et de production.
Configuration server-to-server.
Limitations et points à considérer
Veuillez noter que :
L’intégration ne peut être finalisée tant que le prestataire n’a pas approuvé le compte.
Les délais dépendent du prestataire ou de la banque.
Les identifiants doivent correspondre au bon environnement.
Des informations incorrectes peuvent empêcher la connexion.
L’activation du 3D Secure dépend de la configuration du compte.
La tokenisation doit être souscrite si nécessaire.
Les opérations MIT et MOTO nécessitent une autorisation spécifique.
Les préautorisations ne sont pas disponibles si la banque ne les active pas.
Les webhooks doivent être configurés exactement avec l’URL fournie.
PowerTranz nécessite un site web opérationnel pour effectuer les tests.
Redsys requiert des configurations spécifiques de la part de la banque.
Amazon Payment Services utilise 3D Secure par défaut.
N’effectuez pas de paiements réels avant d’avoir terminé les tests.
La modification d’un identifiant peut interrompre les encaissements.
Avant de remplacer une passerelle existante, vérifiez ce qu’il adviendra des paiements en attente des réservations déjà créées.
Bonnes pratiques
Confirmez la compatibilité avant de commencer le processus.
Utilisez toujours un compte entreprise.
Finalisez l’onboarding avant de demander la connexion.
Demandez les identifiants de production.
Ne partagez jamais de mots de passe ou de clés sur des canaux non autorisés.
Copiez les identifiants sans espaces supplémentaires.
Stockez les clés dans un gestionnaire sécurisé.
Limitez les accès administratifs.
Activez l’authentification à deux facteurs lorsque c’est possible.
Configurez correctement le 3D Secure v2.
Demandez la tokenisation dès le début si vous en avez besoin.
Effectuez des tests dans tous les environnements nécessaires.
Vérifiez les webhooks après l’activation.
Contrôlez à la fois les paiements initiaux et ultérieurs.
Documentez les changements réalisés par votre banque.
Ne désactivez pas l’ancienne connexion avant d’avoir validé la nouvelle.
Cas pratique
Une entreprise espagnole souhaite conserver les conditions de son TPE Redsys et automatiser ses encaissements via Avantio Payments.
Elle commence par contacter Avantio pour vérifier que sa banque est compatible.
Après signature du contrat, elle demande à la banque l’activation du protocole SIS REST PSPS, MIT, MOTO, 3D Secure v2 et des préautorisations.
Lorsque la banque confirme la configuration, l’entreprise transmet à Avantio le Merchant ID, le MCC, le numéro de terminal et les Acquirer BIN.
Avantio finalise la configuration et l’entreprise effectue une réservation test. Elle vérifie également une préautorisation pour s’assurer qu’elle peut bien retenir et libérer une caution.
Une fois toutes les opérations vérifiées, elle commence à utiliser la connexion avec des réservations réelles.
Erreurs fréquentes
La banque ne connaît pas le protocole demandé
Fournissez à la banque le nom complet du protocole ainsi que les opérations à activer.
Si besoin, la banque peut contacter Avantio à l’adresse [email protected].
Redsys ne traite pas les paiements ultérieurs
Vérifiez que les opérations MIT sont bien activées.
Vérifiez aussi la configuration MOTO si les transactions concernent certains portails.
La préautorisation ne fonctionne pas
Confirmez auprès de la banque que les préautorisations sont bien activées sur le terminal concerné.
L’activation générale du TPE n’implique pas forcément que cette opération soit disponible.
Le paiement n’aboutit pas avec 3D Secure
Vérifiez que 3D Secure v2 est bien activé sur le compte et que le prestataire a correctement configuré l’authentification.
PowerTranz ne peut pas finaliser les tests
Vérifiez que la page web est bien en ligne et accessible.
Assurez-vous également d’utiliser la version de PowerTranz compatible avec 3D Secure v2.
Les identifiants PowerTranz ne fonctionnent pas
Vérifiez si les identifiants correspondent à l’environnement de test ou de production.
N’utilisez pas d’identifiants de test pour traiter des paiements en production.
Amazon Payment Services refuse la connexion
Vérifiez que MerchantId, AccessCode, ShaRequest et ShaResponse sont bien renseignés et appartiennent au même compte.
Assurez-vous également que l’onboarding est terminé.
Impossible de traiter des paiements ultérieurs avec Amazon Payment Services
Vérifiez que la tokenisation est activée.
Avoir souscrit à la passerelle ne signifie pas forcément que le service de tokenisation est activé.
Axerve n’actualise pas le statut des paiements
Vérifiez la configuration du webhook.
L’URL doit être ajoutée dans :
Configurazione → Ambiente → Url server to server
L’ApiKey Axerve n’est pas valide
Vérifiez que la clé est bien celle de production et qu’elle ne contient pas d’espaces ou de caractères supplémentaires.
La réservation de test fonctionne, mais le paiement réel échoue
Vérifiez que le test n’a pas été effectué uniquement sur un environnement de test.
Assurez-vous que le compte et les identifiants de production sont actifs.
Si quelque chose ne fonctionne pas
Avant de contacter l’équipe Customer Experience :
Vérifiez que le contrat est bien signé.
Assurez-vous que l’onboarding est complet.
Confirmez que le compte est approuvé.
Vérifiez que les identifiants sont corrects.
Vérifiez s’ils appartiennent à l’environnement de test ou de production.
Vérifiez que 3D Secure v2 est activé.
Confirmez que la tokenisation est activée si nécessaire.
Vérifiez les configurations réalisées par la banque.
Vérifiez l’URL du webhook.
Confirmez que la page web est opérationnelle.
Vérifiez le statut de la transaction dans le tableau de bord du prestataire.
Actualisez la page et vérifiez à nouveau le résultat.
Effectuez une nouvelle réservation de test.
Si le problème persiste, ouvrez un ticket et indiquez :
Nom de l’entreprise.
Plateforme utilisée.
Banque ou acquéreur, si applicable.
Identifiant de la réservation.
Date et heure de l’opération.
Montant et devise.
Statut de la transaction.
Message d’erreur complet.
Captures d’écran.
Environnement dans lequel l’erreur s’est produite.
Confirmation des activations effectuées.
N’incluez pas de mots de passe, d’ApiKeys complètes ou d’autres identifiants sensibles dans les captures d’écran.
Questions fréquentes
Dois-je souscrire à la plateforme avant de la connecter ?
Dois-je souscrire à la plateforme avant de la connecter ?
Oui. Vous devez signer le contrat et compléter l’onboarding directement avec la banque ou le prestataire.
Avantio intervient dans l’intégration technique, mais ne remplace pas le contrat commercial.
Combien de temps prend l’activation ?
Combien de temps prend l’activation ?
Cela dépend de la plateforme :
Redsys via Worldline peut prendre plusieurs jours ou semaines.
PowerTranz peut nécessiter plusieurs jours et différentes phases de test.
Amazon Payment Services prend généralement plusieurs jours.
Axerve peut être activé le jour même après réception des informations correctes.
Les délais sont donnés à titre indicatif.
Qu’est-ce que la tokenisation ?
Qu’est-ce que la tokenisation ?
La tokenisation remplace les données d’une carte par une référence sécurisée.
Elle permet d’effectuer certaines opérations ultérieures sans stocker directement les informations sensibles de la carte.
Qu’est-ce qu’un webhook ?
Qu’est-ce qu’un webhook ?
Un webhook est une URL qui permet à la plateforme d’envoyer des notifications automatiques à Avantio lorsqu’un paiement change de statut.
Sur Axerve, il doit être configuré dans la section Url server to server.
Quelle est la différence entre MIT et MOTO ?
Quelle est la différence entre MIT et MOTO ?
MIT désigne les transactions initiées par le commerçant sur une carte déjà autorisée.
MOTO est utilisé pour certaines opérations où le paiement est initié via des canaux comme l’email ou le téléphone. Dans cette intégration, il peut être nécessaire pour traiter certaines transactions provenant de portails.
À quoi servent les préautorisations ?
À quoi servent les préautorisations ?
Elles permettent de bloquer temporairement un montant sans effectuer l’encaissement définitif.
Elles peuvent par exemple servir à gérer des cautions et à libérer ensuite le montant retenu.
Est-il obligatoire de faire une réservation de test ?
Est-il obligatoire de faire une réservation de test ?
Oui, c’est fortement recommandé.
La réservation de test permet de vérifier le paiement, l’authentification, les notifications et les opérations ultérieures avant de traiter de vraies réservations.
Puis-je envoyer les identifiants par email ?
Puis-je envoyer les identifiants par email ?
Utilisez uniquement le canal sécurisé indiqué par l’équipe Customer Experience.
N’envoyez pas de mots de passe ni de clés sensibles via des canaux non autorisés.
Qui peut m’aider lors de la connexion ?
Qui peut m’aider lors de la connexion ?
Vous pouvez contacter votre Account Manager ou l’équipe Customer Experience d’Avantio.
Nous pouvons vous aider via un ticket de support ou, si besoin, par visioconférence.