Gestion des remboursements avec Razorpay

Dokos permet désormais de lister l'ensemble des remboursements associés à un paiement Razorpay directement depuis l'interface. Cette fonctionnalité est particulièrement utile pour la réconciliation des paiements et le suivi des transactions.

Prérequis

• Un compte Razorpay configuré dans Dokos
• Des paiements effectués via Razorpay
• Des droits d'accès aux paramètres de la passerelle de paiement

Lister les remboursements d'un paiement

Pour consulter les remboursements associés à un paiement spécifique :

1. Accédez à Développeur > Passerelle de paiement > Paramètres Razorpay
2. Sélectionnez le document de configuration Razorpay
3. Dans la section Outils de développement, utilisez la méthode fetch_refunds
4. Saisissez l'identifiant du paiement Razorpay (ex: pay_ABC123XYZ)
5. Cliquez sur Exécuter

      
sequenceDiagram
    participant Utilisateur
    participant Dokos
    participant Razorpay
    Utilisateur->>Dokos: Appelle fetch_refunds(payment_id)
    Dokos->>Razorpay: GET /v1/payments/{id}/refunds
    Razorpay-->>Dokos: Liste des remboursements
    Dokos-->>Utilisateur: Affiche les résultats

    

Structure des données retournées

La méthode retourne un tableau d'objets contenant les informations suivantes pour chaque remboursement :

• id : Identifiant unique du remboursement
• amount : Montant remboursé (en paise)
• currency : Devise du remboursement
• status : État du remboursement (ex: processed, failed)
• created_at : Date de création du remboursement
• speed_processed : Vitesse de traitement (ex: normal, optimum)

Exemple d'utilisation

Imaginons que le client Maison Verte SARL ait effectué un paiement de 150,00€ via Razorpay (identifiant pay_DEF456UVW) et que deux remboursements partiels aient été effectués :

[
    {
        "id": "rfnd_GHI789JKL",
        "amount": 5000,
        "currency": "EUR",
        "status": "processed",
        "created_at": 1723987200,
        "speed_processed": "normal"
    },
    {
        "id": "rfnd_MNO012PQR",
        "amount": 3000,
        "currency": "EUR",
        "status": "processed",
        "created_at": 1724073600,
        "speed_processed": "normal"
    }
]

Cas d'usage

Cette fonctionnalité est particulièrement utile pour :

• La réconciliation comptable : Vérifier que tous les remboursements ont bien été enregistrés
• Le support client : Répondre aux questions des clients sur l'état de leurs remboursements
• L'audit : Vérifier l'historique complet des transactions pour un paiement donné

Limitations

• La méthode retourne uniquement la première page de résultats (limite par défaut de Razorpay)
• Les montants sont retournés en paise (100 paise = 1 EUR)
• Nécessite des droits d'accès aux paramètres de la passerelle de paiement

Bonnes pratiques

1. Vérifiez les permissions : Assurez-vous que seuls les utilisateurs autorisés peuvent accéder à cette fonctionnalité
2. Gérez les erreurs : En cas d'échec de l'appel API, un message d'erreur sera affiché
3. Documentez les remboursements : Ajoutez des notes dans Dokos pour expliquer la raison des remboursements
4. Synchronisez régulièrement : Utilisez cette méthode pour maintenir vos données à jour avec Razorpay

::: tip Pour les développeurs : Cette méthode peut être appelée depuis un script personnalisé en utilisant frappe.get_doc("Razorpay Settings").fetch_refunds(payment_id). :::