Configuration du portefeuille d'applications DEUNA
Sur cette page
Aperçu#
Ce guide couvre la configuration côté commerçant de Portefeuille d'applications Deuna dans le panneau d'administration de Deuna. La configuration est une configuration unique qui détermine le mode de paiement que vos clients utiliseront.
Accéder à la configuration#
Étape 1 : Connectez-vous à l'administrateur Deuna
- Accédez à l'administrateur de DEUNA
- Entrez vos identifiants de marchand
- Cliquez Connectez-vous
Étape 2 : Accédez aux méthodes de paiement
- Dans la barre latérale gauche, accédez à Connexions
- Cliquez sur Méthodes de paiement
- Rechercher Portefeuille d'applications Deuna dans la liste
Configuration initiale#
Activation du portefeuille d'applications Deuna
Si Portefeuille d'applications Deuna n'est pas encore activé :
- Trouver Portefeuille d'applications Deuna dans la liste Modes de paiement
- Cliquez Activer ou Ajouter
- Un panneau de configuration s'ouvrira avec un formulaire pour ajouter le processeur
- Remplissez tout quatre champs d'informations d'identification obligatoires (voir rubrique ci-dessous)
- Sélectionnez votre préféré mode de paiement (voir rubrique ci-dessous)
- Cliquez Enregistrer
Le mode de paiement est désormais actif et apparaîtra comme une option pour vos clients lors du paiement.
Ajout du processeur de portefeuille d'applications Deuna
Lorsque vous activez Portefeuille d'applications Deuna, vous devez ajouter le processeur avec les informations d'identification de votre compte Deuna App Wallet.
Pour ajouter le processeur :
- Dans le panneau de configuration de Deuna App Wallet
- Cliquez Ajouter un processeur ou Configurer les informations d'identification
- Remplissez les quatre champs obligatoires :
Champs obligatoires
| Champ | Descriptif | Exemple | Remarques |
|---|---|---|---|
| Public API Key | Appelé « Clé API » dans le portefeuille d'applications Deuna | pub_abc123xyz789 | Mappe vers l'en-tête x-api-key |
| Private API Key | Appelé « API Secret » dans le portefeuille d'applications Deuna | sec_abc123xyz789 | Mappe vers l'en-têtex-api-secret |
| Point de vente (CAJA) | Appelé « CAJA » dans le portefeuille d'applications Deuna | 4200069 | Identifiant de chaîne de votre point de vente |
| Formater | Type de code de paiement | QR ou CODIGO_6_DIGITOS | Détermine si les clients reçoivent un code QR ou à 6 chiffres |
Formulaire étape par étape
Important :
- Les quatre champs sont requis
- Vos informations d'identification proviennent de votre compte professionnel Deuna App Wallet
- La sélection du format détermine ici le mode de paiement pour toutes les commandes
- Après l'enregistrement, les informations d'identification sont cryptées et stockées en toute sécurité
Choisir votre format de paiement#
Lorsque vous remplissez le formulaire du processeur, vous devez sélectionner votre format de paiement. Ce choix est fait lors de l'ajout des informations d'identification et détermine la manière dont vos clients interagiront avec le flux de paiement.
Guide de sélection des formats
| Aspect | Code numérique (CODIGO_6_DIGITOS) | Code QR |
|---|---|---|
| Le client voit | Code à 6 chiffres | Code QR dynamique |
| Fenêtre de temps | 3 minutes | 15 minutes |
| Comment payer | Tapez dans l'application | Scannez ou cliquez |
| Idéal pour | Paiement sur ordinateur/tablette | Paiement axé sur le mobile |
| Expérience utilisateur | Saisie manuelle requise | Rapide, en un seul clic/analyse |
| Valeur du champ | CODIGO_6_DIGITOS | QR |
Format 1 : Code numérique (CODIGO_6_DIGITOS, 3 Minutes)
Choisissez ceci si :
- Vos clients utilisent principalement un ordinateur/une tablette
- Vous souhaitez une fenêtre de transaction rapide
- Votre flux de paiement s'exécute sur plusieurs types d'appareils
- Vous préférez la simplicité et les dépendances minimales
Comment ça marche :
- Le client voit un grand code à 6 chiffres
- Le code expire dans exactement 3 minutes
- Le client doit ouvrir l'application Deuna et saisir le code manuellement
- Après avoir entré, le client confirme dans l'application
- Paiement confirmé via webhook
Pour sélectionner ce format :
- Sous la forme du processeur
- Sous Formater, sélectionnez Code numérique (CODIGO_6_DIGITOS)
- Remplissez le formulaire et cliquez Enregistrer le processeur
Vérification :
- Une fois enregistré, vous verrez un message de confirmation
- Toutes les commandes ultérieures utiliseront des codes numériques à 6 chiffres
Format 2 : QR Code (15 Minutes)
Choisissez ceci si :
- Vos clients sont principalement des utilisateurs mobiles
- Vous souhaitez une fenêtre de transaction plus longue pour plus de flexibilité
- Vous préférez une expérience moderne en un seul clic
- La numérisation QR est courante sur votre marché cible
Comment ça marche :
- Le client voit un code QR dynamique
- Le code QR est valable exactement 15 minutes
- Le client peut soit :
- Numériser avec la caméra Deuna App
- Cliquez pour ouvrir l'application directement
- Paiement confirmé via webhook
Pour sélectionner ce format :
- Sous la forme du processeur
- Sous Formater, sélectionnez Code QR
- Remplissez le formulaire et cliquez Enregistrer le processeur
Vérification :
- Une fois enregistré, vous verrez un message de confirmation
- Toutes les commandes ultérieures utiliseront des codes QR
Panneau de configuration#
Configuration de dépannage
Problème : Impossible de trouver le portefeuille de l'application Deuna dans la liste des méthodes de paiement
Solution :
- Actualiser la page
- Vérifiez que vous disposez de l'autorisation « Paiements » dans votre rôle d'utilisateur
- Contactez l'assistance Deuna pour vous assurer que Deuna App Wallet est configuré pour votre compte.
Problème : le processeur n'enregistre pas ou affiche une erreur
Solution :
- Vérifiez que les quatre champs d'informations d'identification sont remplis :
- Clé API publique (non vide)
- Clé API privée (non vide)
- Point de vente / CAJA (non vide, chaîne numérique)
- Format sélectionné (QR ou Code Numérique)
- Vérifiez que les informations d'identification sont correctes à partir de votre compte Deuna App Wallet
- Testez d'abord vos informations d'identification dans le tableau de bord Deuna App Wallet
- Réessayez dans un autre navigateur
- Contactez l'assistance Deuna si le problème persiste
Problème : les clients ne peuvent pas voir le portefeuille de l'application Deuna lors du paiement
Vérifiez :
- Le portefeuille de l'application Deuna est Activé (non désactivé)
- Le processeur est correctement configuré (les quatre champs sont remplis)
- La commande du client est en cours USD monnaie
- Le client est dans Équateur (ou en utilisant l'adresse de facturation de l'Équateur)
- Le widget de paiement comprend
deuna_walletprocesseur - Le jeton de commande a été généré avec succès
Si tout est vérifié :
- Contacter l'assistance Deuna
Autorisations et accès#
Rôles d'administrateur requis
Pour configurer Deuna App Wallet, votre compte utilisateur doit avoir :
- Connexions - Autorisation de lecture/écriture
- Méthodes de paiement - Autorisation de lecture/écriture
- Webhooks - Autorisation de lecture/écriture (pour la configuration du webhook)
Si vous manquez d'autorisations :
- Demandez au propriétaire ou à l'administrateur de votre compte
- Ils peuvent accorder des autorisations dans Rôles et autorisations des utilisateurs section
Configuration multi-administrateur
Si plusieurs administrateurs gèrent les paiements :
- Toutes les modifications de configuration sont visibles par tous les administrateurs
- Tout administrateur peut changer de mode de paiement (non recommandé sans communication)
- Activez les journaux d'audit pour suivre les modifications :
- Aller à Rôles et autorisations des utilisateurs
- Activer Journal d'activité
Meilleures pratiques#
Configuration
✅ Faire :
- Tester la connectivité du webhook après la configuration
- Choisissez le mode de paiement en fonction de votre clientèle
- Vérifiez les limites de remboursement avant d'activer
- Documentez votre choix de mode pour votre équipe
❌ Ne :
- Désactivez Deuna App Wallet sans en informer votre équipe
- Changer fréquemment de mode de paiement sans raison
- Partager des URL de webhooks dans des canaux non sécurisés
- Supposons que la sélection du mode puisse être annulée par commande (ce n'est pas possible)
Surveillance
✅ Faire :
- Vérifiez les paramètres de paiement chaque semaine
- Consultez régulièrement les journaux de livraison des webhooks
- Surveiller les demandes de remboursement pour connaître les tendances
- Testez la connectivité des webhooks mensuellement
❌ Ne :
- Ignorer les échecs des webhooks pendant des périodes prolongées
- Ignorer les tests d'intégration des commerçants
- Oubliez de mettre à jour l'URL du webhook si votre backend change