Aller au contenu principal
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

  1. Accédez à l'administrateur de DEUNA
  2. Entrez vos identifiants de marchand
  3. Cliquez Connectez-vous

Étape 2 : Accédez aux méthodes de paiement

  1. Dans la barre latérale gauche, accédez à Connexions
  2. Cliquez sur Méthodes de paiement
  3. 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é :

  1. Trouver Portefeuille d'applications Deuna dans la liste Modes de paiement
  2. Cliquez Activer ou Ajouter
  3. Un panneau de configuration s'ouvrira avec un formulaire pour ajouter le processeur
  4. Remplissez tout quatre champs d'informations d'identification obligatoires (voir rubrique ci-dessous)
  5. Sélectionnez votre préféré mode de paiement (voir rubrique ci-dessous)
  6. 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 :

  1. Dans le panneau de configuration de Deuna App Wallet
  2. Cliquez Ajouter un processeur ou Configurer les informations d'identification
  3. Remplissez les quatre champs obligatoires :

Champs obligatoires

ChampDescriptifExempleRemarques
Public API KeyAppelé « Clé API » dans le portefeuille d'applications Deunapub_abc123xyz789Mappe vers l'en-tête x-api-key
Private API KeyAppelé « API Secret » dans le portefeuille d'applications Deunasec_abc123xyz789Mappe vers l'en-têtex-api-secret
Point de vente (CAJA)Appelé « CAJA » dans le portefeuille d'applications Deuna4200069Identifiant de chaîne de votre point de vente
FormaterType de code de paiementQR ou CODIGO_6_DIGITOSDé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

AspectCode numérique (CODIGO_6_DIGITOS)Code QR
Le client voitCode à 6 chiffresCode QR dynamique
Fenêtre de temps3 minutes15 minutes
Comment payerTapez dans l'applicationScannez ou cliquez
Idéal pourPaiement sur ordinateur/tablettePaiement axé sur le mobile
Expérience utilisateurSaisie manuelle requiseRapide, en un seul clic/analyse
Valeur du champCODIGO_6_DIGITOSQR

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 :

  1. Le client voit un grand code à 6 chiffres
  2. Le code expire dans exactement 3 minutes
  3. Le client doit ouvrir l'application Deuna et saisir le code manuellement
  4. Après avoir entré, le client confirme dans l'application
  5. Paiement confirmé via webhook

Pour sélectionner ce format :

  1. Sous la forme du processeur
  2. Sous Formater, sélectionnez Code numérique (CODIGO_6_DIGITOS)
  3. 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 :

  1. Le client voit un code QR dynamique
  2. Le code QR est valable exactement 15 minutes
  3. Le client peut soit :
    • Numériser avec la caméra Deuna App
    • Cliquez pour ouvrir l'application directement
  4. Paiement confirmé via webhook

Pour sélectionner ce format :

  1. Sous la forme du processeur
  2. Sous Formater, sélectionnez Code QR
  3. 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 :

  1. 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)
  2. Vérifiez que les informations d'identification sont correctes à partir de votre compte Deuna App Wallet
  3. Testez d'abord vos informations d'identification dans le tableau de bord Deuna App Wallet
  4. Réessayez dans un autre navigateur
  5. 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 :

  1. Le portefeuille de l'application Deuna est Activé (non désactivé)
  2. Le processeur est correctement configuré (les quatre champs sont remplis)
  3. La commande du client est en cours USD monnaie
  4. Le client est dans Équateur (ou en utilisant l'adresse de facturation de l'Équateur)
  5. Le widget de paiement comprend deuna_wallet processeur
  6. 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 :

  1. Demandez au propriétaire ou à l'administrateur de votre compte
  2. Ils peuvent accorder des autorisations dans Rôles et autorisations des utilisateurs section

Configuration multi-administrateur

Si plusieurs administrateurs gèrent les paiements :

  1. Toutes les modifications de configuration sont visibles par tous les administrateurs
  2. Tout administrateur peut changer de mode de paiement (non recommandé sans communication)
  3. 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