Rembourser des Paiements

Le processus de remboursement de paiement est la procédure par laquelle vous allez rembourser un client pour un paiement antérieur. Dans ce guide, vous trouverez des instructions sur le remboursement d'un paiement créé précédemment sur Yuno.

Prérequis

Pour rembourser 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 le Paiement  et des données de capture si l'opération de capture a été exécutée à l'aide de  Capturer le 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. Vous utiliserez une source différente pour cette information, selon la façon dont vous avez capturé le paiement.
    • Si vous avez créé et capturé le paiement en utilisant une seule opération, vous obtenez le transaction_id à partir du paramètre transaction.id après la création du paiement avec l'endpoint  Créer le Paiement .
    • Si vous avez effectué l'autorisation puis la capture du paiement, vous utiliserez le transaction_id à partir du paramètre id reçu après la capture du paiement à l'aide du l'endpoint  Capturer le paiement .

📘

Explorer les Collections Postman de Yuno

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

Rembourser un Paiement

Si vous initiez un remboursement, il remboursera une charge créée précédemment mais pas encore remboursée. Le montant sera crédité sur la méthode de paiement originale qui a été débitée.

Utilisez l'endpoint  remboursement de paiement avec transaction  pour effectuer le remboursement. Pour identifier le paiement à rembourser, vous devez fournir son id  et  transaction_id. Si vous n'avez pas besoin de retourner une transaction spécifique, utilisez  endpoint paiement des remboursements  pour effectuer le remboursement basé sur le paiement. De plus, vous devez informer le montant à rembourser en utilisant l'objet amount dans le corps de la requête :

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

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

• status = REFUNDED
• sub_status = REFUNDED
• transaction.type = REFUND
• transaction.status = SUCCEEDED

Si la réponse contient les valeurs ci-dessus, le remboursement a été effectué avec succès.

📘

Délai de traitement des remboursements

Le délai de traitement des remboursements varie en fonction du type de paiement. En mode test, les remboursements sont traités instantanément dans l'environnement Sandbox.

Vérifier le Statut du Paiement

Si, pour une raison quelconque, vous devez confirmer le remboursement 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.