Pour permettre à vos clients d'effectuer des pré-autorisations en ligne de manière autonome, vous devez lier votre compte marchand Viva Wallet à votre système Restomax.
Suivez ce guide étape par étape pour récupérer vos identifiants API et finaliser l'intégration.
Étape 1 : Récupérer Vos Identifiants Viva Wallet
Connectez-vous à votre Portail Viva Wallet et rassemblez de côté de l'écran les informations suivantes:
Identifiant du compte (Account ID)
Dans le menu de gauche, allez sur le Dashboard. Copiez le Viva Account ID affiché en haut à droite.
Identifiant marchand & Clé API
Allez dans Settings (Paramètres) > API Access et sélectionnez l'onglet General en haut. Vous y trouverez l'Identifiant marchand et la Clé API sous la section Access credentials.
Identifiant client & Secret client
Restez sur l'onglet General et descendez jusqu'à Smart Checkout Credentials. Copiez l'Identifiant client, puis cliquez pour générer un Secret client.
⚠️ Important : Vous ne pouvez voir le Secret client qu'une seule fois. Veillez à le copier et à le noter précieusement avant de quitter la page.
Étape 2 : Créer une Source de Paiement dans Viva Wallet
Vous devez maintenant autoriser Restomax en tant que canal de paiement électronique :
Dans votre portail Viva Wallet, allez dans Sales (Ventes) > Online Payments > Websites / Apps.
En haut à droite, cliquez sur le bouton Add Website/App (Ajouter Site Web/App).
Remplissez le formulaire contextuel exactement comme suit :
- Source Name : Le nom de votre établissement (ex : Salon Mon Restaurant - Book).
- Domain name : redirection-handler.restomax.com.
- Protocol : HTTPS.
- Integration method : Redirection/Native Checkout v2.
- Success URL : https://redirection-handler.restomax.com/book?state=success
- Failure URL : https://redirection-handler.restomax.com/book?state=failure
Cliquez sur Enregistrer. Repérez votre nouvelle source dans la liste et copiez le Code numérique à 4 chiffres. C'est votre Code source du site Web.
Étape 3 : Créer le Profil de Paiement dans Restomax
Il ne reste plus qu'à insérer ces clés au sein de votre interface Restomax :
Connectez-vous à votre Backoffice Restomax, allez dans Book dans le menu principal, puis cliquez sur Profils de paiement.
Cliquez sur + Créer un nouveau profil en haut à droite.
Donnez-lui un nom clair (ex : Viva Wallet - Book) et assurez-vous que l'interrupteur Actif soit coché en vert.
Dans la section Paramètres, collez soigneusement l'ensemble des données récoltées :
- Identifiant du compte
- Code source du site Web
- Identifiant marchand
- Clé API
- Identifiant client
- Secret client
Cliquez sur Save and Close (Enregistrer et Fermer).
Étape 4 : Configurer Vos Webhooks en Temps Réel
Pour que Restomax soit immédiatement informé du succès of de l'échec d'une transaction, vous devez paramétrer deux alertes (webhooks) :
Revenez sur votre portail Viva Wallet > Settings > API Access et sélectionnez l'onglet Webhooks en haut. Cliquez sur le lien Create Webhook (Créer un Webhook).
Webhook 1 (Synchronisation des Succès) :
URL : Saisissez l'adresse suivante : https://ws-cnc.restomax.com/api/v8/Payments/VivaWallet/Webhook/<VIVA_ACCOUNT_ID> (Prenez soin de remplacer <VIVA_ACCOUNT_ID> de votre identifiant de compte Viva Wallet réel).
Assurez-vous que la case Active soit cochée.
Définissez l'Event Type (Type d'événement) sur Transaction Payment Created et cliquez sur Save.
Webhook 2 (Synchronisation des Échecs) :
Cliquez à nouveau sur Create Webhook.
Copiez-collez exactement la même URL que l'étape précédente.
Veillez à ce que la case Active soit cochée, changez l'Event Type pour sélectionner Transaction Failed, puis cliquez sur Save.
Votre système de garantie par empreinte bancaire automatisé est désormais entièrement connecté et opérationnel !