Les sources sont utilisées pour identifier et gérer les paiements en ligne effectués via Smart Checkout, les plugins et d’autres payment tools. Vous trouverez plus d’informations sur chaque option dans le Viva.com Developer Portal, respectivement dans les sections Smart Checkout, Plugins et Payment tools.
➡️ Ajouter une source
Pour ajouter une source pour les paiements en ligne, suivez ces étapes :
Connectez-vous à Viva.com et sélectionnez le compte concerné (démo ou réel).
Allez dans Ventes → Paiements en ligne → Sites web/Applications.
Sélectionnez Ajouter un site web/une application.
Renseignez les informations requises dans la fenêtre contextuelle comme suit :
Code – Le numéro à quatre chiffres en haut à gauche du champ est le « Code source » – l’identifiant unique de cette source de paiement. Ce code est généré automatiquement, mais vous pouvez choisir une autre valeur si vous le souhaitez (par exemple à des fins organisationnelles). Si vous utilisez notre Payment API, ce code est transmis via le paramètre sourceCode lors de la création d’un ordre de paiement. Pour plus d’informations, consultez la page de documentation Payment API dans le Viva.com Developer Portal.
Nom de la source – En plus du Code source, vous pouvez également attribuer un nom à votre source de paiement. Cela vous permet d’identifier plus facilement la source dans votre compte et dans vos rapports (comme le rapport de règlement, par exemple).
Compte lié – Sélectionnez le compte (portefeuille) que vous souhaitez lier à cette source de paiement. Lorsque cette source de paiement est utilisée, les fonds seront déposés sur le compte sélectionné. Vous pouvez lier plusieurs sources différentes à un seul compte si vous le souhaitez.
Protocole – Si votre plateforme e-commerce utilise SSL lors du paiement, sélectionnez https. Si votre plateforme n’utilise pas SSL (comme c’est le cas dans certains environnements de développement, par exemple), sélectionnez http.
Nom de domaine – Saisissez le domaine qui sera lié à cette source de paiement. Vous n’avez pas besoin d’inclure la barre oblique finale (\) ni le protocole (http:// ou https://). Par exemple :
Si votre site utilise www : www.votredomaine.com
Si votre site n’utilise pas www : votredomaine.com
Méthode d’intégration – Laissez sur Redirection/Native Checkout v2.
Logo de l’entreprise – Téléversez le logo de votre entreprise à associer à cette source de paiement, au format PNG avec transparence, jusqu’à 100 Ko (taille recommandée : 128 x 128 pixels). C’est une étape importante, car le logo apparaîtra sur votre page de paiement et aidera les clients à reconnaître et confirmer votre entreprise.
URL de succès (Success URL) – C’est l’URL de la page vers laquelle le client sera redirigé après un paiement réussi. Par exemple, vous pouvez l’utiliser pour afficher une page de confirmation de paiement ou une page qui remercie le client pour son règlement.
URL d’échec (Failure URL) – C’est l’URL de la page vers laquelle le client sera redirigé après un paiement échoué. Par exemple, vous pouvez l’utiliser pour renvoyer le client à la dernière étape du processus de paiement afin qu’il puisse réessayer la transaction.
Paramètres avancés – À ce stade, vous pouvez activer l’affichage d’un bouton Annuler dans Smart Checkout, ainsi que modifier les noms des paramètres d’URL ajoutés aux Success/Failure URL après une transaction. Pour plus d’informations sur les paramètres ajoutés aux Success et Failure URLs, consultez la page Viva.com Developer Portal – Response information dans la section Integration reference et reportez-vous aux paramètres de la chaîne de requête de la réponse.
Pour activer le bouton Annuler dans Smart Checkout, activez l’option Cancel Button. Lorsque le bouton Annuler est cliqué, Smart Checkout redirigera vers votre Failure URL avec le paramètre cancel dans la requête.
Remarque :
Actuellement, le bouton Annuler est pris en charge pour les intégrations directes avec Smart Checkout, ainsi que pour des fonctionnalités spécifiques dans nos plugins pour Shopify et PrestaShop.
Il est également possible de recevoir des webhooks pour les événements d’annulation de commande. Consultez la page Viva.com Developer Portal – Order Updated dans la section Webhooks for payments pour obtenir des informations sur le webhook Order Updated et les événements d’annulation de commande.
Les paramètres par défaut sont :
Parameter | Default Name |
Cancellation status | cancel |
Order Code | s |
Transaction ID | t |
Language | lang |
Il est recommandé de conserver ces paramètres par défaut, sauf si des modifications spécifiques sont nécessaires pour les aligner avec les systèmes internes.
Enfin, examinez les informations situées à côté de chaque case à cocher en bas de l’écran. Vous devez accepter ces conditions afin de créer la source de paiement. Une fois que vous avez sélectionné toutes les options, cliquez sur le bouton Créer pour finaliser le processus.


