Capturer des Paiements

Dans ce guide, vous trouverez des instructions étape par étape pour saisir manuellement un paiement précédemment créé sur Yuno.

📘

Capture automatique différée

Si vous préférez que Yuno capture automatiquement les paiements après un délai spécifié, vous pouvez configurer delayed_capture_settings lors de la création du paiement. Pour en savoir plus, consultez la section Flux d'Annulation et de Capture valide.

🚧

Quels Paiements Pouvez-vous Capturer

Seuls les paiements ayant le statut EN COURS peuvent être capturés. Consultez la page Statut des paiements pour plus de détails concernant les statuts de paiement possibles.

Prérequis

Pour capturer un paiement, vous devez :

• Accéder à vos  Identifiants API sur le Tableau de bord de Yuno, qui consistent en :
  • public-api-key
  • private-secrete-key
• Disposer des données d'identification du paiement reçues après la création du paiement à l'aide du l'endpoint  Créer Paiement:
  • id: L'identifiant unique du paiement, obtenu à partir du paramètre id après la création du paiement.
  • transaction_id: L'identifiant unique de la transaction, obtenu à partir du paramètre transaction.id après la création du paiement.

📘

Explorer les Collections Postman de Yuno

Yuno fournit des Collections Postman que vous pouvez utiliser pour reproduire les cas d'utilisation localement.

💡

Options de capture

Ce guide traite de la capture manuelle à l'aide du endpoint API. Pour d'autres options de capture, notamment :

• Capture en temps réel (achat immédiat)
• Capture différée (capture automatique après un délai)

Consultez le guide Annuler et capturer le flux.

Capturer un Paiement

Vous ne pouvez capturer un paiement que s'il a le statut EN COURS. Utilisez  l'endpoint capture un paiement pour capturer le paiement. Pour identifier le paiement à capturer, vous devez fournir son id  et  transaction_id. De plus, vous devez informer le montant à capturer en utilisant l'objet amount dans le corps de la requête :

• Remboursement complet : Laisser le montant vide.
• Remboursement partiel : Fournissez la valeur du remboursement à l'aide du paramètre amount.

Pour confirmer que vous avez réussi à capturer le paiement, vérifiez si les paramètres de la réponse du endpoint Capturer un paiement contiennent les valeurs suivantes :

• type = CAPTURE
• status = SUCCEEDED
• payment.status = SUCCEEDED
• payment.sub_status = CAPTURED/PARTIALLY_CAPTURED

Si la réponse contient les valeurs ci-dessus, la capture a été réussie.

Vérifier le Statut du Paiement

Si, pour une raison quelconque, vous devez confirmer l'annulation du paiement :

• Utilisez Récupérer le paiement par ID ou Récupérer le paiement par merchant_order_id pour obtenir des informations détaillées sur le paiement.
• Alternativement, configurez des webhooks pour recevoir des notifications pour chaque événement. Référez-vous au guide Webhooks pour savoir comment configurer les webhooks dans Yuno.