Introduction
Intégrez Viva.com Smart Checkout pour permettre aux clients d’effectuer des paiements sécurisés via une page de paiement hébergée. Ce guide vous guide à travers les étapes d’une intégration transparente dans votre site Web ou votre application.
➤ Obtenez votre compte Viva.com, si vous n’en avez pas déjà un
Viva.com prend en charge deux environnements différents, assurez-vous d’utiliser le bon :
Environnement | Description | URL d’inscription | URL du tableau de bord |
Production | Pour effectuer des paiements dans le monde réel | ||
Manif | Pour effectuer des paiements de test et à d’autres fins de test |
➤ Obtenez votre source de paiement en ligne et conservez votre code source
Une source de paiement est une entité de configuration qui permet aux marchands de configurer et de gérer les paramètres d’intégration des paiements pour leurs sites Web ou applications mobiles.
Configurez votre domaine et les URL où Viva.com Smart Checkout redirigera les clients une fois le paiement terminé. Ces URL mènent généralement à des pages telles que « Merci pour votre commande » pour les paiements réussis ou « Quelque chose s’est mal passé avec votre paiement » pour les transactions échouées, ce qui permet aux clients de poursuivre leur parcours de manière transparente sur votre site Web ou votre application.
Créez une source de paiement pour les paiements en ligne, en accédant à Ventes > Paiements en ligne > Site internet / Apps dans le tableau de bord Viva.com.
Assurez-vous de sauvegarder le code source à 4 chiffres de la source de paiement que vous venez de créer, car vous en aurez besoin ultérieurement à des fins d’intégration et de configuration.
Exemple de configuration de la source de paiement avec le code source 6602
Consultez ici un guide détaillé sur la façon de créer une Source pour les paiements en ligne
➤ Guide d’intégration étape par étape
Les étapes clés de l’intégration
Création de l’ordre de paiement
Rediriger vers Smart Checkout
Gérer le retour client et vérifier le résultat du paiement
➥ Étape 1 : Création de l’ordre de paiement |
Pour demander un paiement à l’un de vos clients, vous devez créer un ordre de paiement. Chaque ordre de paiement se voit attribuer un identifiant unique à 16 chiffres, également appelé orderCode.
Vous pouvez générer l’ordre de paiement à l’aide de l’API Créer un ordre de paiement sur votre serveur et transmettre l’orderCode à votre site Web ou à votre application.
Pour plus de détails sur la configuration d’un ordre de paiement, consultez notre guide détaillé sur notre portail des développeurs ici et ici.
➥ Étape 2 : Rediriger le client vers Smart Checkout |
Lorsqu’ils sont redirigés, les clients voient le formulaire Smart Checkout pour saisir leurs informations de paiement et finaliser la transaction.
➤ Options supplémentaires pour Smart Checkout
Options de source de paiement
Affichez le logo de votre marque
Vous pouvez inclure le logo de votre marque à afficher sur Smart Checkout en le configurant dans les paramètres de la source de paiement. Il y a un guide détaillé sur notre portail des développeurs ici.
L’ajout de votre logo améliore l’expérience client en renforçant votre identité de marque lors du processus de paiement. Assurez-vous de télécharger un logo clair et de taille appropriée pour un affichage optimal.
➤ Afficher un bouton d’annulation
La mise à disposition d’un bouton Annuler offre de la flexibilité à vos clients et contribue à améliorer l’expérience utilisateur globale.
Vous pouvez configurer un bouton Annuler sur Smart Checkout pour offrir aux clients la possibilité d’annuler leurs commandes. Ceci est géré au niveau de la source de paiement (sous Configuration avancée), ce qui vous permet de contrôler si le bouton Annuler est disponible pour les commandes associées à une source spécifique.
Plateformes prises en charge : Le bouton Annuler est actuellement pris en charge pour les intégrations directes de Smart Checkout et les plugins pour Shopify et PrestaShop.
Prise en charge des webhooks : vous pouvez configurer les webhooks pour recevoir des notifications en cas d’annulation de commande. Suivez ce Guide de configuration du webhook pour plus d’informations
➥ Étape 3 : Gérer le retour du client et vérifier le résultat du paiement |
Gérer le retour client
Après le paiement, les clients sont redirigés vers :
URL de réussite pour des paiements réussis.
URL d’échec pour les paiements ayant échoué.
Vous pouvez configurer ces paramètres via le tableau de bord de votre compte Viva.com sous Ventes > Paiements en ligne > Site internet / Apps
Vérifier le résultat du paiement
La vérification permet de s’assurer que la transaction est menée à bien. Pour valider le statut d’une transaction dans votre système, recoupez les paramètres suivants : Amount, transactionId, statusId Afficher tous les codes StatusId
➤ Méthodes de vérification de paiement recommandées :
Webhooks :
Recevez des mises à jour en temps réel en cas de réussite ou d’échec des paiements.
Reportez-vous à notre documentation sur les webhooks Transaction Payment Created et Transaction Failed pour plus de détails sur la mise en œuvre, des exemples de charges utiles et une explication de tous les paramètres.
Couvre à la fois les modes de paiement synchrones et asynchrones.
Récupérer l’API de transaction :
Pour plus de détails sur l’appel d’API et ses paramètres, reportez-vous à la documentation Retrieve Transaction API sur notre portail des développeurs
➤ Configuration supplémentaire
Avec Viva.com Smart Checkout, nous avons préparé de nombreuses fonctionnalités et outils que vous pouvez utiliser et donner à vos clients plus d’options pour leurs paiements.
Paiements récurrents : mode de paiement dans lequel le commerçant (vous) initie automatiquement les frais selon un calendrier prédéfini sans impliquer le client après le premier paiement.
Pré-autorisations : Un mode de paiement utilisé pour vérifier la disponibilité des fonds et réserver le montant, le transfert réel des fonds commençant plus tard.
Vous pouvez trouver des guides détaillés sur notre portail des développeurs pour procéder à toutes les configurations que vous pouvez effectuer via votre compte pour accepter les paiements en ligne, ainsi que pour explorer toutes les alternatives et services que nous offrons.