Configurer et utiliser les remboursements Razorpay

Dokos prend en charge les remboursements via Razorpay, permettant aux utilisateurs de traiter les demandes de remboursement directement depuis l'interface. Cette fonctionnalité inclut également un webhook sécurisé pour recevoir les notifications de remboursement depuis Razorpay.

Prérequis

• Un compte Razorpay actif (mode Test ou Live).
• Les informations d'API Razorpay configurées dans Dokos (clé API et secret API).
• Un solde suffisant sur votre compte Razorpay pour couvrir les remboursements.

Configuration du webhook Razorpay

Pour recevoir les notifications de remboursement depuis Razorpay, vous devez configurer un webhook dans votre tableau de bord Razorpay et dans Dokos.

Étape 1 : Configurer le webhook dans Razorpay

1. Connectez-vous à votre tableau de bord Razorpay.
2. Allez dans Settings > Webhooks.
3. Cliquez sur Add New Webhook.
4. Dans le champ Webhook URL, entrez l'URL suivante :

   https://<votre-site-dokos>/api/method/payments.payment_gateways.doctype.razorpay_settings.webhook.razorpay_webhook
   

5. Dans le champ Secret, entrez un secret de votre choix (vous devrez le saisir également dans Dokos).
6. Sélectionnez les événements suivants :
   • refund.processed
   • refund.failed
7. Cliquez sur Create Webhook.

Étape 2 : Configurer le webhook dans Dokos

1. Allez dans Dodock > Paiements > Paramètres Razorpay.
2. Dans la section Webhook Secret, saisissez le secret que vous avez défini dans le tableau de bord Razorpay.
3. Enregistrez les modifications.

      
flowchart TD
    A[Razorpay envoie une notification de remboursement] --> B[Webhook Dokos reçoit la notification]
    B --> C{Vérification de la signature HMAC}
    C -->|Signature valide| D[Création d'une Integration Request]
    C -->|Signature invalide| E[Refus de la requête - Erreur dans le journal]
    D --> F[Appel du hook handle_refund_notification]
    F --> G[Notification envoyée aux applications abonnées]

    

Effectuer un remboursement

Depuis l'interface Dokos

1. Allez dans Paiements > Historique des paiements.
2. Sélectionnez le paiement que vous souhaitez rembourser.
3. Cliquez sur le bouton Rembourser.
4. Dans la fenêtre modale, vous pouvez :
   • Rembourser le montant total restant.
   • Saisir un montant partiel à rembourser (en euros).
5. Cliquez sur Confirmer pour lancer le remboursement.

Depuis le tableau de bord Razorpay

Les remboursements effectués directement depuis le tableau de bord Razorpay sont également synchronisés avec Dokos via le webhook. Cependant, pour des raisons de traçabilité, il est recommandé d'effectuer les remboursements depuis Dokos lorsque cela est possible.

Gérer les erreurs de remboursement

Si un remboursement échoue, Dokos enregistre l'erreur et vous pouvez consulter les détails dans les journaux d'erreurs. Voici les erreurs courantes :

• Solde insuffisant : Votre compte Razorpay n'a pas assez de fonds pour couvrir le remboursement.
• Paiement non capturé : Le paiement n'a pas été capturé et ne peut donc pas être remboursé.
• Montant invalide : Le montant saisi est négatif ou dépasse le montant restant à rembourser.
• Signature invalide : Le webhook a reçu une notification avec une signature invalide (vérifiez le secret du webhook).

Bonnes pratiques

• Vérifiez toujours le solde de votre compte Razorpay avant d'effectuer un remboursement pour éviter les erreurs.
• Utilisez le mode Test pour tester les remboursements avant de passer en production.
• Surveillez les journaux d'intégration pour vous assurer que les notifications de remboursement sont bien reçues.
• Documentez les raisons des remboursements dans les commentaires des paiements pour une meilleure traçabilité.

Exemple d'utilisation

Scénario : La société Maison Verte SARL a effectué un paiement de 100 € via Razorpay pour une commande. Le client retourne une partie des articles et demande un remboursement partiel de 40 €.

1. Allez dans Paiements > Historique des paiements et sélectionnez le paiement de 100 €.
2. Cliquez sur Rembourser et saisissez 40 dans le champ montant.
3. Confirmez le remboursement.
4. Le montant de 40 € est remboursé au client, et le solde restant du paiement est mis à jour à 60 €.
5. Razorpay envoie une notification de remboursement via le webhook, et Dokos met à jour le statut du paiement en conséquence.