Les sources sont utilisées pour les paiements en ligne via Smart Checkout, les plugins et nos outils de paiement.
➡️ 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.
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.
Si vous utilisez l’un de nos plugins, les Success URL et Failure URL peuvent nécessiter des valeurs spécifiques. Veuillez consulter le tableau des URL des plugins ci-dessous.
Plugin name | Success URL |
WooCommerce Smart Checkout |
|
OpenCart Smart Checkout |
|
Magento Smart Checkout |
|
Plugin name | Failure URL |
WooCommerce Smart Checkout |
|
OpenCart Smart Checkout |
|
Magento Smart Checkout |
|
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 (voir Response information | Viva.com Developer Portal).
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. Suivez ce guide (Order Updated | Viva.com Developer Portal) afin de configurer un webhook pour les annulations 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.