पुष्ट भुगतान सूचना फिर भेजें

POST /api/v1/webhooks/resend

प्रमाणीकरण का अनुरोध करें

X-Bolt-Key, X-Bolt-Timestamp और X-Bolt-Signature शामिल करें। वर्तमान मिलीसेकंड timestamp का उपयोग करें और सटीक अनुरोध निकाय के साथ उस पर हस्ताक्षर करें।

फिर से कब भेजें

इस एंडपॉइंट का उपयोग तब करें जब आपके सिस्टम को पुष्टि किए गए भुगतान की एक और अधिसूचना की आवश्यकता हो। दोबारा भेजने से भुगतान एकत्रित नहीं होता, स्थानांतरण का समाधान नहीं होता या कोई ऑर्डर नहीं बनता।

केवल आपके अपने CONFIRMED या COMPLETED ऑर्डर दोबारा भेजे जा सकते हैं। PENDING, PAID और अन्य राज्य पात्र नहीं हैं।

एक उपलब्ध, सक्रिय Webhook कॉन्फ़िगरेशन की आवश्यकता है। यदि कोई वितरण कार्य जारी नहीं रहता है, तो समापन बिंदु QUEUED के बजाय एक त्रुटि देता है।

01. अनुरोध पैरामीटर

application/json

externalOrderIdआवश्यक

String

व्यापारी को ऑर्डर निर्माण के समय आपूर्ति किया गया externalOrderId भेजें, orderToken नहीं। आप केवल वर्तमान API कुंजी से संबंधित ऑर्डर के लिए सूचनाएं दोबारा भेज सकते हैं।

उदाहरण मान

{"externalOrderId": "INV-20260209-99281"}

आवश्यक स्ट्रिंग, 6-64 अक्षर। अक्षर, अंक, अंडरस्कोर (_) और हाइफ़न (-) की अनुमति है।

Body

02. प्रतिक्रिया फ़ील्ड (data)

application/json

notifyUrlString

आदेश पर दर्ज कॉलबैक पता; null हो सकता है। डिलीवरी इस पते को प्राथमिकता देती है और बिना पुराने ऑर्डर के लिए संबंधित Webhook कॉन्फ़िगरेशन पर वापस आ जाती है।

externalOrderIdString

व्यापारी आदेश ID इस पुनः भेजने से संबद्ध है, जो अनुरोध externalOrderId से मेल खाता है।

triggerTypeEnum

इस समापन बिंदु की प्रतिक्रिया में हमेशा MANUAL होता है, जो व्यापारी द्वारा अनुरोधित पुनः भेजने का संकेत देता है। यह भुगतान निपटान प्रकार नहीं है.

statusEnum

अनुरोध स्थिति पुनः भेजें। QUEUED का अर्थ है कि कार्य जारी था; यह न तो भुगतान की स्थिति है और न ही डिलीवरी का प्रमाण है।

QUEUED का अर्थ है कि भेजने का कार्य सहेजा गया है और बाद में भेजा जाएगा; इसका अर्थ सूचना पहुँच जाना नहीं है। व्यापारी डैशबोर्ड के डिलीवरी लॉग और प्राप्तकर्ता की HTTP 2xx प्रतिक्रिया देखें।

🚀

प्राप्तकर्ता प्रबंधन

X-Bolt-Webhook-Timestamp और X-Bolt-Webhook-Signature को सत्यापित करें, फिर पूर्ति से पहले eventId या मर्चेंट ऑर्डर ID द्वारा डुप्लिकेट करें। उन डुप्लिकेट सूचनाओं के लिए HTTP 2xx लौटाएं जिन्हें पहले ही सफलतापूर्वक प्रबंधित किया जा चुका है।

triggerType: MANUAL पुनः भेजें प्रतिक्रिया और डैशबोर्ड डिलीवरी रिकॉर्ड में दिखाई देता है। वर्तमान Webhook अनुरोध निकाय में triggerType शामिल नहीं है; पुनः भेजने की पहचान करने के लिए इस पर निर्भर न रहें।
प्रत्येक सफल कॉल एक स्वतंत्र डिलीवरी कार्य बनाता है। बार-बार अनुरोध करने पर अनेक सूचनाएं भेजी जा सकती हैं. दोबारा भेजने से पहले डिलीवरी लॉग जांचें। रिप्ले तार्किक eventId को बरकरार रखता है।
यह समापन बिंदु ऑर्डर के कॉलबैक गंतव्य का पुन: उपयोग करता है और एक नया URL स्वीकार नहीं करता है। डैशबोर्ड डिफ़ॉल्ट को बदलने से ऑर्डर पर पहले से सहेजा गया पता प्रतिस्थापित नहीं होता है।

Safe

सामान्य त्रुटियाँ

ये सामान्य मामले हैं। विफलताओं का निदान करने के लिए वास्तविक HTTP स्थिति और प्रतिक्रिया कोड/संदेश का उपयोग करें। त्रुटि प्रतिक्रिया भुगतान परिणाम नहीं है।

401: API कुंजी, रॉ-बॉडी हस्ताक्षर और वर्तमान मिलीसेकंड timestamp (सर्वर घड़ी के 5 मिनट के भीतर) की जांच करें।
404: ऑर्डर गुम है, किसी अन्य व्यापारी का है या आपके प्लान द्वारा अनुमत इतिहास से बाहर है।
400: ऑर्डर CONFIRMED / COMPLETED नहीं है, या उपलब्ध Webhook कॉन्फ़िगरेशन और सफलतापूर्वक संग्रहीत डिलीवरी कार्य गायब है।