Aller au contenu principal
Tous les systèmes sont opérationnelsNouveautésv1
Se connecter
POSThttps://api.sandbox.deuna.io/v2/merchants/orders/purchase

Traiter le paiement d’une commande

Traite une commande existante ou fournie dans la requête à l’aide du parcours de paiement et de routage configuré dans DEUNA.

API v2 · Verified October 2, 2026

Utilisez cette opération depuis le backend marchand pour traiter le jeton d’une commande existante ou une commande incluse dans la requête. DEUNA applique les connexions de paiement ainsi que la configuration de routage, de risque et de capture du marchand.

En-têtes#

4
X-Api-KeystringObligatoire
Clé privée de l’application marchand validée par l’API Gateway.
Exemple YOUR_PRIVATE_API_KEY
AuthorizationstringFacultatif
Contexte facultatif de l’utilisateur authentifié pour les moyens de paiement et instruments enregistrés.
Exemple Porteur du jeton d'accès USER_ACCESS_TOKEN
X-Store-CodestringFacultatif
Contexte de boutique lorsqu’une configuration propre à la boutique existe.
Exemple principal
Content-TypestringObligatoire
Doit être application/json.

Paramètres de route#

0
Cet endpoint n’a aucun paramètre de route.

Corps de la requête#

8
order_tokenstringFacultatif
Jeton d’une commande existante. Fournissez ce champ ou un objet commande que DEUNA peut créer.
orderobjectFacultatif
Détails de la commande lorsque le paiement doit la créer et la traiter en une seule requête.
payer_infoobjectObligatoire
Identité du client. L’API exige payer_info.email Instrument et données de connexion utilisés pour traiter le paiement.
Afficher les attributs enfants
payer_info.emailstringObligatoire
Adresse e-mail du client utilisée pour identifier le payeur.
payer_info.external_user_idstringFacultatif
Identifiant du client dans le système du commerçant.
payment_sourceobjectObligatoire
Contexte client, appareil, navigateur et risque pour les services antifraude configurés.
Afficher les attributs enfants
payment_source.method_typestringObligatoire
Type de méthode de paiement, par exemple credit_card ou une autre plateforme de paiement compatible.
payment_source.payment_methodstringFacultatif
Token généré par l'intégration d'un client DEUNA.
payment_source.payment_method_idstringFacultatif
Identifiant du processeur de paiement pour le commerçant, si nécessaire.
payment_source.card_infoobjectFacultatif
Données de carte tokenisées ou conformes à la norme PCI pour les transactions par carte.
anti_fraud_infoobjectFacultatif
Destinations de redirection pour les états de réussite, attente, rejet, annulation ou échec.
callback_urlsobjectFacultatif
Champs propres au fournisseur ou au moyen de paiement sélectionné.
specific_fieldsobjectFacultatif
Contexte d’abonnement lorsque l’achat crée ou renouvelle un abonnement compatible.
subscriptionobjectFacultatif
Contexte d’abonnement lorsque l’achat crée ou renouvelle un abonnement pris en charge.

Commencer avec une commande complète de l'industrie#

Le order Le champ ci-dessus accepte le même contexte commercial modélisé par l'API Orders. Pour une récupération et une tentative plus claires, créez d'abord la commande, conservez ses order_token, et envoyez le jeton dans cette requête.

QSRet lesCompagnies aériennesPNR, passager, billet, itinéraire, tarif, taxe et services additionnels.CinémaProjection, salle, sièges, livraison du billet et concessions.BanquePaiement de compte, produit, canal et contexte de relevé.Commerce de détailProduits, variantes, réductions, expédition et livraison.

Renvoie la commande traitée avec son#

Renvoie la commande traitée, notamment son order_token, le type de commande, le statut obtenu, les informations de paiement et les informations d’abonnement, le cas échéant. Considérez l’état renvoyé comme la source de vérité et poursuivez le suivi asynchrone via les webhooks marchands.

Le paiement a été traité. Consultez l’état de la commande et du paiement pour connaître le résultat métier.

200La requête est invalide ou ne contient pas les données obligatoires du payeur ou de la source de paiement.
400La clé privée ou le contexte d’autorisation client est invalide.
401L’opération est incompatible avec l’état actuel de la commande ou une requête idempotente antérieure.
409La limite de requêtes est dépassée. Respectez
429Retry-After lorsqu’il est renvoyé. Idempotence

La Gateway applique l’idempotence à cette opération. Envoyez une#

stable pour une même tentative métier et réutilisez la même clé et le même corps après une panne réseau. Utilisez une autre clé pour une tentative différente. X-Idempotency-Key Générez la clé dans le backend marchand, jamais dans le navigateur ou l’application mobile.

  • Ne réutilisez jamais une clé avec un corps différent.
  • Consultez la commande avant de lancer une nouvelle tentative lorsque le résultat est incertain.
  • Rapprochez un résultat incertain en récupérant la commande avant de lancer une nouvelle tentative.

entrée complète de l’endpoint , l’, Authentificationet Codes d’erreur.