[{"data":1,"prerenderedAt":509},["ShallowReactive",2],{"\u002Fnext\u002Fdodock\u002Fintegrations\u002Fpaiements\u002Frazorpay":3,"section:\u002Fnext\u002Fdodock\u002Fintegrations\u002Fpaiements\u002Frazorpay":508},{"id":4,"title":5,"body":6,"description":493,"extension":494,"meta":495,"navigation":231,"path":504,"seo":505,"stem":506,"__hash__":507},"docs\u002F2.next\u002F3.dodock\u002F05.integrations\u002F01.paiements\u002Frazorpay.md","Rembourser un paiement Razorpay (développeurs)",{"type":7,"value":8,"toc":483},"minimark",[9,13,22,35,40,72,76,81,145,151,166,176,190,197,245,248,252,257,308,312,325,331,335,339,385,392,405,412,421,460,464,479],[10,11,5],"h1",{"id":12},"rembourser-un-paiement-razorpay-développeurs",[14,15,16,17,21],"p",{},"Cette référence s'adresse aux développeurs. L'application ",[18,19,20],"code",{},"payments"," fournit des méthodes Python pour rembourser un paiement Razorpay et un webhook qui reçoit les notifications de remboursement.",[23,24,27],"callout",{"color":25,"icon":26},"warning","i-mdi-alert",[14,28,29,30,34],{},"Razorpay n'a pas de bouton de remboursement dans le bureau. Le bouton ",[31,32,33],"strong",{},"Remboursement"," d'une écriture de paiement apparaît seulement pour les passerelles v2 qui savent rembourser, et pour Stancer. Razorpay n'est pas une passerelle v2. Un remboursement Razorpay se fait par code ou depuis le tableau de bord Razorpay.",[36,37,39],"h2",{"id":38},"prérequis","Prérequis",[41,42,43,47,62],"ul",{},[44,45,46],"li",{},"Un compte Razorpay (mode test ou production).",[44,48,49,50,53,54,57,58,61],{},"Les ",[31,51,52],{},"Paramètres Razorpay"," remplis : ",[31,55,56],{},"Clé API"," et ",[31,59,60],{},"Secret API",". À l'enregistrement, Dokos teste ces identifiants auprès de l'API Razorpay.",[44,63,64,65,68,69,71],{},"Pour le webhook : un ",[31,66,67],{},"Secret Webhook"," dans les ",[31,70,52],{},".",[36,73,75],{"id":74},"rembourser-par-code","Rembourser par code",[14,77,49,78,80],{},[31,79,52],{}," sont un document unique. Ses méthodes appellent l'API Razorpay.",[82,83,84,97],"table",{},[85,86,87],"thead",{},[88,89,90,94],"tr",{},[91,92,93],"th",{},"Méthode",[91,95,96],{},"Rôle",[98,99,100,115,125,135],"tbody",{},[88,101,102,108],{},[103,104,105],"td",{},[18,106,107],{},"refund_payment(payment_id, amount=None)",[103,109,110,111,114],{},"Rembourse un paiement. ",[18,112,113],{},"amount"," est en unités principales (euros). Sans montant, rembourse tout ce qui reste remboursable.",[88,116,117,122],{},[103,118,119],{},[18,120,121],{},"fetch_refund(refund_id)",[103,123,124],{},"Retourne un remboursement.",[88,126,127,132],{},[103,128,129],{},[18,130,131],{},"fetch_refunds(payment_id)",[103,133,134],{},"Retourne la liste des remboursements d'un paiement. Les montants sont en unités mineures (centimes).",[88,136,137,142],{},[103,138,139],{},[18,140,141],{},"fetch_payment(payment_id)",[103,143,144],{},"Retourne le paiement.",[14,146,147,150],{},[18,148,149],{},"refund_payment()"," refuse le remboursement dans ces cas :",[41,152,153,160,163],{},[44,154,155,156,159],{},"le paiement n'a pas le statut ",[18,157,158],{},"captured"," (« Only captured payments can be refunded »),",[44,161,162],{},"le montant est inférieur ou égal à 0,",[44,164,165],{},"le montant dépasse le reste remboursable (montant du paiement moins montant déjà remboursé).",[14,167,168,169,172,173,71],{},"Un refus de Razorpay (",[18,170,171],{},"BadRequestError",") s'affiche à l'utilisateur. Une erreur serveur de Razorpay va dans le ",[31,174,175],{},"Journal des Erreurs",[14,177,178,179,182,183,186,187,71],{},"Le remboursement retourné reste ",[18,180,181],{},"pending"," jusqu'à son traitement par Razorpay. Vérifiez son état avec ",[18,184,185],{},"fetch_refund()"," ou attendez la notification ",[18,188,189],{},"refund.processed",[14,191,192,193,196],{},"Exemple fictif : un paiement de 100 € (",[18,194,195],{},"pay_DEF456UVW",") reçoit un remboursement partiel de 40 €.",[198,199,204],"pre",{"className":200,"code":201,"language":202,"meta":203,"style":203},"language-python shiki shiki-themes material-theme-lighter material-theme material-theme-palenight","settings = frappe.get_doc(\"Razorpay Settings\")\nrefund = settings.refund_payment(\"pay_DEF456UVW\", 40)\n# refund[\"status\"] == \"pending\"\n\nsettings.fetch_refunds(\"pay_DEF456UVW\")\n# [{\"id\": \"rfnd_GHI789JKL\", \"amount\": 4000, \"currency\": \"EUR\", \"status\": \"processed\", ...}]\n","python","",[18,205,206,214,220,226,233,239],{"__ignoreMap":203},[207,208,211],"span",{"class":209,"line":210},"line",1,[207,212,213],{},"settings = frappe.get_doc(\"Razorpay Settings\")\n",[207,215,217],{"class":209,"line":216},2,[207,218,219],{},"refund = settings.refund_payment(\"pay_DEF456UVW\", 40)\n",[207,221,223],{"class":209,"line":222},3,[207,224,225],{},"# refund[\"status\"] == \"pending\"\n",[207,227,229],{"class":209,"line":228},4,[207,230,232],{"emptyLinePlaceholder":231},true,"\n",[207,234,236],{"class":209,"line":235},5,[207,237,238],{},"settings.fetch_refunds(\"pay_DEF456UVW\")\n",[207,240,242],{"class":209,"line":241},6,[207,243,244],{},"# [{\"id\": \"rfnd_GHI789JKL\", \"amount\": 4000, \"currency\": \"EUR\", \"status\": \"processed\", ...}]\n",[14,246,247],{},"Un second appel sans montant rembourse les 60 € restants.",[36,249,251],{"id":250},"recevoir-les-notifications-de-remboursement","Recevoir les notifications de remboursement",[253,254,256],"h3",{"id":255},"configurer-le-webhook-dans-razorpay","Configurer le webhook dans Razorpay",[258,259,260,270,276,291,297,305],"ol",{},[44,261,262,263,266,267,71],{},"Dans le tableau de bord Razorpay, ouvrez ",[31,264,265],{},"Settings"," > ",[31,268,269],{},"Webhooks",[44,271,272,273,71],{},"Cliquez sur ",[31,274,275],{},"Add New Webhook",[44,277,278,279,282,283],{},"Dans ",[31,280,281],{},"Webhook URL",", saisissez :\n",[198,284,289],{"className":285,"code":287,"language":288},[286],"language-text","https:\u002F\u002F\u003Cvotre-site>\u002Fapi\u002Fmethod\u002Fpayments.payment_gateways.doctype.razorpay_settings.webhook.razorpay_webhook\n","text",[18,290,287],{"__ignoreMap":203},[44,292,278,293,296],{},[31,294,295],{},"Secret",", saisissez un secret de votre choix.",[44,298,299,300,57,302,71],{},"Sélectionnez les événements ",[18,301,189],{},[18,303,304],{},"refund.failed",[44,306,307],{},"Enregistrez le webhook.",[253,309,311],{"id":310},"configurer-le-secret-dans-dokos","Configurer le secret dans Dokos",[258,313,314,317,322],{},[44,315,316],{},"Ouvrez la recherche (Ctrl+K) et saisissez « Paramètres Razorpay ».",[44,318,278,319,321],{},[31,320,67],{},", saisissez le même secret.",[44,323,324],{},"Enregistrez.",[14,326,327,328,330],{},"Sans ",[31,329,67],{},", Dokos refuse toutes les notifications.",[253,332,334],{"id":333},"traitement-dune-notification","Traitement d'une notification",[336,337,338],"mermaid",{},"\nflowchart TD\n    A[Razorpay envoie la notification] --> B{Signature HMAC valide ?}\n    B -->|Non| E[Journal des erreurs, réponse 200]\n    B -->|Oui| C{refund.processed ou refund.failed ?}\n    C -->|Non| F[Ignorée]\n    C -->|Oui| D[Demande d'intégration en file d'attente]\n    D --> G[Tâche de fond : hook handle_refund_notification]\n    G --> H[Demande d'intégration terminée ou en échec]\n",[258,340,341,351,358,365,379],{},[44,342,343,344,347,348,350],{},"Dokos vérifie l'en-tête ",[18,345,346],{},"X-Razorpay-Signature"," avec le ",[31,349,67],{}," (HMAC SHA-256).",[44,352,353,354,57,356,71],{},"Dokos ignore les événements autres que ",[18,355,189],{},[18,357,304],{},[44,359,360,361,364],{},"Dokos crée une ",[31,362,363],{},"Demande d'Intégration"," (service « Razorpay », description « Refund Notification »), avec le corps de la notification.",[44,366,367,368,371,372,57,375,378],{},"Une tâche de fond appelle les méthodes du hook ",[18,369,370],{},"handle_refund_notification",", avec ",[18,373,374],{},"doctype",[18,376,377],{},"docname"," de la demande d'intégration.",[44,380,381,382,384],{},"La demande d'intégration passe au statut « Terminé ». Si une méthode échoue, l'erreur va dans le ",[31,383,175],{}," et la demande passe au statut « Échec ».",[14,386,387,388,391],{},"Razorpay renvoie une notification tant qu'il ne reçoit pas de réponse 2xx. Dokos utilise l'en-tête ",[18,389,390],{},"X-Razorpay-Event-Id"," pour ne pas créer deux fois la même demande d'intégration. Vos méthodes doivent quand même accepter un second appel sans effet de bord.",[23,393,396],{"color":394,"icon":395},"info","i-mdi-information",[14,397,398,399,401,402,404],{},"L'application ",[18,400,20],{}," n'abonne aucune méthode à ",[18,403,370],{},". Sans méthode déclarée par votre application, la notification est seulement enregistrée.",[14,406,407,408,411],{},"Exemple fictif de déclaration dans ",[18,409,410],{},"hooks.py"," (noms à adapter) :",[198,413,415],{"className":200,"code":414,"language":202,"meta":203,"style":203},"handle_refund_notification = \"mon_app.paiements.razorpay.on_refund\"\n",[18,416,417],{"__ignoreMap":203},[207,418,419],{"class":209,"line":210},[207,420,414],{},[198,422,424],{"className":200,"code":423,"language":202,"meta":203,"style":203},"import frappe\n\n\ndef on_refund(doctype, docname):\n    data = frappe.parse_json(frappe.db.get_value(doctype, docname, \"data\"))\n    refund = data[\"payload\"][\"refund\"][\"entity\"]\n    # Mettre à jour vos documents à partir de refund[\"id\"] et refund[\"status\"]\n",[18,425,426,431,435,439,444,449,454],{"__ignoreMap":203},[207,427,428],{"class":209,"line":210},[207,429,430],{},"import frappe\n",[207,432,433],{"class":209,"line":216},[207,434,232],{"emptyLinePlaceholder":231},[207,436,437],{"class":209,"line":222},[207,438,232],{"emptyLinePlaceholder":231},[207,440,441],{"class":209,"line":228},[207,442,443],{},"def on_refund(doctype, docname):\n",[207,445,446],{"class":209,"line":235},[207,447,448],{},"    data = frappe.parse_json(frappe.db.get_value(doctype, docname, \"data\"))\n",[207,450,451],{"class":209,"line":241},[207,452,453],{},"    refund = data[\"payload\"][\"refund\"][\"entity\"]\n",[207,455,457],{"class":209,"line":456},7,[207,458,459],{},"    # Mettre à jour vos documents à partir de refund[\"id\"] et refund[\"status\"]\n",[36,461,463],{"id":462},"pages-liées","Pages liées",[41,465,466,473],{},[44,467,468],{},[469,470,472],"a",{"href":471},"\u002Fnext\u002Fdodock\u002Ffonctionnalites\u002Fintegrations\u002Fdemandes-integrations","Demandes d'intégration",[44,474,475],{},[469,476,478],{"href":477},"\u002Fnext\u002Fdodock\u002Fintegrations\u002Fpaiements\u002Fpayment-controller-v2","Intégrer une passerelle avec PaymentController v2",[480,481,482],"style",{},"html .light .shiki span {color: var(--shiki-light);background: var(--shiki-light-bg);font-style: var(--shiki-light-font-style);font-weight: var(--shiki-light-font-weight);text-decoration: var(--shiki-light-text-decoration);}html.light .shiki span {color: var(--shiki-light);background: var(--shiki-light-bg);font-style: var(--shiki-light-font-style);font-weight: var(--shiki-light-font-weight);text-decoration: var(--shiki-light-text-decoration);}html .default .shiki span {color: var(--shiki-default);background: var(--shiki-default-bg);font-style: var(--shiki-default-font-style);font-weight: var(--shiki-default-font-weight);text-decoration: var(--shiki-default-text-decoration);}html .shiki span {color: var(--shiki-default);background: var(--shiki-default-bg);font-style: var(--shiki-default-font-style);font-weight: var(--shiki-default-font-weight);text-decoration: var(--shiki-default-text-decoration);}html .dark .shiki span {color: var(--shiki-dark);background: var(--shiki-dark-bg);font-style: var(--shiki-dark-font-style);font-weight: var(--shiki-dark-font-weight);text-decoration: var(--shiki-dark-text-decoration);}html.dark .shiki span {color: var(--shiki-dark);background: var(--shiki-dark-bg);font-style: var(--shiki-dark-font-style);font-weight: var(--shiki-dark-font-weight);text-decoration: var(--shiki-dark-text-decoration);}",{"title":203,"searchDepth":210,"depth":216,"links":484},[485,486,487,492],{"id":38,"depth":216,"text":39},{"id":74,"depth":216,"text":75},{"id":250,"depth":216,"text":251,"children":488},[489,490,491],{"id":255,"depth":222,"text":256},{"id":310,"depth":222,"text":311},{"id":333,"depth":222,"text":334},{"id":462,"depth":216,"text":463},"Méthodes de remboursement des Paramètres Razorpay et webhook de notification des remboursements, pour les développeurs.","md",{"icon":496,"reviewed":231,"last_verified":497,"sources":498},"i-mdi-credit-card-refund","2026-11-03",[499,500,501,502,503],"payments\u002Fpayment_gateways\u002Fdoctype\u002Frazorpay_settings\u002Frazorpay_settings.py","payments\u002Fpayment_gateways\u002Fdoctype\u002Frazorpay_settings\u002Frazorpay_settings.json","payments\u002Fpayment_gateways\u002Fdoctype\u002Frazorpay_settings\u002Fwebhook.py","payments\u002Foverrides\u002Fpayment_entry.py","payments\u002Fpublic\u002Fjs\u002Fpayment_entry.js","\u002Fnext\u002Fdodock\u002Fintegrations\u002Fpaiements\u002Frazorpay",{"title":5,"description":493},"2.next\u002F3.dodock\u002F05.integrations\u002F01.paiements\u002Frazorpay","72DMxYJzPy5X63Uns9hRCNP4ZAk3pGzKZb_ZGK_yIAg",{},1795274576908]