Foire aux questions
Trouvez le guide DEUNA mis à jour pour les questions courantes concernant l'administration, les API, le processus de paiement, les SDK, les plugins, les tests et les webhooks.
Sur cette page
Ces réponses font référence à la source d'information la plus à jour, plutôt que de dupliquer les contrats de configuration ou d'API qui peuvent évoluer. Si une page ne documente pas une fonctionnalité, considérez-la comme non confirmée et demandez à votre responsable technique DEUNA (TAM) avant de la mettre en œuvre.
Administrateur#
Comment obtenir l'accès à l'interface d'administration DEUNA ?
Un opérateur autorisé de votre organisation doit vous inviter et vous attribuer le rôle nécessaire à votre tâche. Commencez par Gérer les utilisateurs et les rôles, puis Authentification à deux facteurs Si votre compte ou votre organisation le requiert. Les identifiants API ne créent pas de session d'administrateur.
Où puis-je configurer un processeur ou une méthode de paiement ?
Ouvrez Connexions Dans le tableau de bord, et en suivant les instructions spécifiques à ce fournisseur. Les informations d'identification et la disponibilité sont spécifiques au compte et à l'environnement. Utilisez Connexions pour comprendre le flux de travail et Catalogue des prestataires pour vérifier que la fonctionnalité est correctement publiée avant de la configurer.
Puis-je personnaliser l'apparence du processus de paiement ?
Oui, en utilisant les options prises en charge par votre expérience de paiement. Utilisez Thème et contrôles partagés pour la configuration du thème DEUNA et la page de personnalisation spécifique à l'intégration lorsque celle-ci ajoute ses propres contraintes. Assurez-vous que le contraste, la visibilité et les mises en page pour les appareils mobiles restent utilisables après chaque modification.
Intégration API#
Puis-je m'intégrer directement via l'API ?
Oui. Exécutez le guide de démarrage rapide de l'API à partir d'un backend de confiance, puis utilisez catalogue des endpoints pour le contrat de requête et de réponse public exact. Ne placez jamais une clé API privée dans un navigateur ou une application mobile.
Quel identifiant de connexion dois-je utiliser ?
La réponse dépend de l'endroit où la requête est exécutée et de l'autorité dont elle a besoin. Un SDK côté client utilise le contexte d'application public documenté ; les opérations serveur-à-serveur de confiance utilisent une clé API privée ; les flux de clients authentifiés pris en charge peuvent également utiliser un jeton Bearer du client. Le tableau de décision et les exemples de hachage sont dans Authentification et clés API.
Comment tester sans impacter l'environnement de production ?
Utilisez les identifiants de test et l'URL de base de test documentée dans Principes d’intégration. Conservez les clés de test et de production, les webhooks, les comptes de fournisseur et la configuration du commerçant séparément. Validez à la fois les flux réussis et les flux infructueux avant de demander l'activation en production.
Où sont documentés les codes de réponse et d'erreur ?
Le Erreurs et récupération La référence correspondante explique les codes de statut publics et les procédures de récupération. La référence spécifique à un point de terminaison reste la référence autoritaire pour ses exigences de requête, de réponse, d'audience et d'autorisation.
Paiement, SDK et plugins#
Quelle intégration de paiement dois-je choisir ?
Choisissez en fonction de l'expérience utilisateur que vous souhaitez offrir, de la plateforme sur laquelle elle est déployée et des limites de confiance pour les données de paiement. Vérification Web compare le chemin principal du site web, tandis que Aperçu du SDK Définition des responsabilités pour les applications Web, iOS, Android et React Native.
Où trouver les méthodes et les fonctions de rappel du SDK ?
Commencez par Aperçu du SDK, sélectionnez votre plateforme, et utilisez la plateforme partagée. Événement et Réponse Références, si applicable.
Quelles méthodes de paiement puis-je afficher ?
La disponibilité des méthodes de paiement dépend du pays, de la devise, du canal, de la connexion au prestataire et de la configuration du compte. Filtrez les résultats générés. Catalogue des prestataires, puis suivez les instructions spécifiques au prestataire ou à la méthode de paiement choisie. Ne vous fiez pas à une capture d'écran ou à l'expérience d'un autre commerçant pour déterminer la disponibilité.
Est-il possible de s'intégrer via un plugin de commerce ?
Utilisation Plugins Pour consulter les intégrations de plateformes de commerce prises en charge. Pour VTEX, commencez par Vue d'ensemble de VTEX, complétez les guides d'installation et de configuration, et effectuez un achat de test avant le déploiement en production.
Comment les coupons, les taxes, les frais de port ou les pourboires affectent-ils le processus de paiement ?
Ces mécanismes peuvent utiliser des callbacks asynchrones spécifiques au commerçant, si cette fonctionnalité est configurée pour votre compte. Webhook de paiement dynamique Ce guide explique les limites d'exécution, la correspondance des requêtes et des réponses, la validation et la gestion des erreurs. Ne pas utiliser de callback ou de champ mutable non certifié pour votre entreprise.
Webhooks et résultats de paiement#
Ai-je besoin d'un webhook ?
Utilisez les webhooks de statut lorsque votre backend doit réagir aux changements de paiement asynchrones sans dépendre du navigateur, d'un redirigissement ou d'un appel de retour d'un SDK. Certains modes de paiement atteignent leur état final après que le client ait quitté le processus de paiement. Implémentez le flux de notification signé. et valider l'état de commande officiel avant la livraison ou toute autre action irréversible.
Que se passe-t-il si un webhook est retardé, dupliqué ou reçu hors ordre ?
Vérifiez la signature, acceptez durablement la notification, éliminez les doublons et empêchez un événement plus ancien de faire reculer votre enregistrement local. La livraison n'est pas une preuve de la sémantique "exactement une fois" ou de l'ordre de cycle de vie. Suivez Accusez réception et réconciliez et utilisez un processus de réconciliation séparé pour les paiements non résolus.
Un appel de fonction SDK ou un redirigement de navigateur est-il une preuve de paiement ?
Non. La finalisation côté client est utile pour l'expérience utilisateur, mais votre backend doit utiliser le résultat côté serveur et le flux de statut asynchrone documentés avant la livraison. Conservez l'état de l'interface utilisateur, l'état du paiement et l'état de règlement comme des préoccupations distinctes.
Documentation et outils d'IA#
Un agent de codage basé sur l'IA peut-il rechercher dans ces documents ?
Oui. Connectez un client compatible à la version de lecture seule. Documentation du serveur MCP de DEUNA. Il consulte la même documentation publique, la liste des points de terminaison et le catalogue des fournisseurs publiés sur ce site, et ne nécessite ni ne prend en charge vos identifiants DEUNA.
Une fonctionnalité n'est pas documentée. Devrais-je supposer qu'elle fonctionne ?
Non. Veuillez le confirmer auprès de votre représentant technique DEUNA ou du propriétaire du contrat public concerné. Indiquez l'environnement, le produit, le prestataire, l'utilisation prévue et la page publique consultée, mais supprimez les clés API, les jetons, les données de carte, les clés privées et les données des clients.