Aller au contenu principal
Tous les systèmes sont opérationnelsNouveautésv1
Se connecter
DEUNA API

Référence API

Choisissez l’opération d’API, le modèle d’autorisation et l’appelant adaptés à chaque flux d’intégration DEUNA.

Dernière mise à jour : October 2, 2026Collection Postman
Sur cette page

La référence de l’API DEUNA couvre les opérations du backend marchand et des applications clientes publiées dans la documentation précédente. Commencez par l’appelant, et pas seulement par le nom de la ressource, car le modèle d’autorisation pris en charge varie selon la surface. Les autres routes de l’API Gateway sont volontairement exclues de cette référence.

Utilisez la navigation de la référence API pour parcourir les opérations publiées par domaine produit et ressource.

Exemples de requêtes de commande et de paiementCopiez des requêtes Purchase V2 complètes et des requêtes facultatives de création de commande par secteur.AuthentificationChoisissez les bons identifiants et le bon modèle d’autorisation pour chaque appelant.Créer un paiementExaminer le contrat de paiement complet et le panneau de requête interactif.API ThemesCréez et gérez des configurations de thème de Checkout et de Widget réutilisables.

URL de base#

Utilisez l'URL de base de l'environnement de test. Passez à la production uniquement après avoir obtenu les identifiants de production et terminé la certification.

Bac à sable
https://api.sandbox.deuna.io
Production
https://api.deuna.io

Choisir la surface API#

SurfaceAppelant prévuAutorisationUtilisez-le pour
Backend du commerçant · communication entre serveursInfrastructure sécurisée pour les commerçantsClé API privée dans X-Api-Key; X-Store-Code et en utilisant les en-têtes idempotents si nécessaireCommandes, achats, captures, remboursements, annulations et consultations opérationnelles
Application client · communication entre utilisateur et serveurApplication web ou mobile du commerçant pour le compte d'un clientContexte d'application public plus l'utilisateur Authorization: Bearer … après connexion ; ne jamais inclure une clé privéeConnexion facultative, profils et adresses réutilisables, et cartes enregistrées

Authentification#

Backend du commerçant

Envoyer la clé API privée dans X-Api-Key, et non dans l'en-tête Bearer. Conserver sur une infrastructure de serveur sécurisée.

En-têtes de requête serveur-serveurHTTP
X-Api-Key: YOUR_PRIVATE_API_KEY
X-Store-Code: STORE_CODE
X-Idempotency-Key: order_1042-attempt_1
Content-Type: application/json

Client authentifié

Envoyez le jeton d’accès utilisateur dans l’en-tête Bearer. Certaines opérations de commande et de portefeuille nécessitent également la clé d’application du marchand ou le contexte de la boutique ; chaque page d’opération indique son autorisation et les en-têtes transmis.

En-têtes de requête client-serveurHTTP
Authorization: Bearer USER_ACCESS_TOKEN
X-Api-Key: APPLICATION_API_KEY
X-Store-Code: STORE_CODE
Content-Type: application/json

Voir Authentification pour la gestion des identifiants, la durée de vie des jetons et la rotation.

Opérations côté serveur du commerçant#

POST
/merchants/orders
Créer une commande et obtenir son jeton de commande
GET
/merchants/orders/{order_token}
Récupérer l'état actuel de la commande et du paiement
GET
/merchants/orders/{order_token}/payments-methods
Obtenir les méthodes de paiement disponibles pour la commande
POST
/v2/merchants/orders/purchase
Créer un paiement
POST
/v2/merchants/orders/{order_token}/capture
Effectuer un paiement autorisé
POST
/v2/merchants/orders/{order_token}/refund
Effectuer un remboursement complet ou partiel
GET
/merchants/checkout/themes
Listez et gérez les thèmes de Checkout du marchand

Opérations d'application du client#

POST
/users/request-code
Demander un code de connexion unique
POST
/users/login
Échanger un OTP contre un jeton utilisateur
GET
/users/me
Lire le profil utilisateur authentifié
GET
/users/{user_id}/cards
Lister les cartes enregistrées pour l'utilisateur authentifié
PATCH
/users/{user_id}/cards/{card_id}/set-as-default
Définir ou retirer la carte par défaut de l’utilisateur authentifié

Réponses et erreurs#

2xxLa requête a réussi.
4xxL'authentification, les autorisations, les données d'état ou les données de requête doivent être modifiées. Inspectez le code d'erreur renvoyé.
5xxDEUNA ou un fournisseur a échoué. N'essayez de réessayer que lorsque l'opération est idempotente, en utilisant la même clé d'idempotence.

Consultez la liste complète dans Codes d’erreur.

Gestion des versions de chemin#

Utilisez chaque chemin exactement comme publié. L'API Gateway expose fréquemment des routes canoniques sans une référence interne. /api/v1 Préfixe. Un segment de version, par exemple /v2 Ce segment est inclus uniquement lorsque la route publique affichée dans le catalogue. Les modifications rétrocompatibles sont répertoriées dans Historique des modifications.