IOSOR ज्ञान

वेबहुक हस्ताक्षर और रीप्ले विंडो: 02:00 उबाऊ रहे इसके लिए idempotency

हस्ताक्षर जाँचें, रीप्ले विंडो बाँधें, इनबाउंड वेबहुक idempotent करें — बिना हस्ताक्षर callback स्वीकार न करें, retry पर prepaid दो बार डेबिट न करें।

बिना हस्ताक्षर callback घटना नहीं। वह अप्रमाणित HTTP है जो संयोग से आपके पेलोड जैसा दिखता है। «पहले स्वीकार, बाद में जाँच» करने वाली टीमें 02:00 पर चुकाती हैं: दोहराया DLR, डुप्लिकेट STOP, या दूसरा वॉलेट डेबिट जिसे वित्त वापस नहीं कर सकता। Prepaid असफलता को पैसे के रूप में दिखाता है। उबाऊ आदतें: हर अनुरोध पर हस्ताक्षर जाँच, सीमित रीप्ले विंडो, लेजर पंक्ति के पास वित्त पढ़े idempotency कुंजी।.

IOSOR ऑडिट योग्य B2B एकीकरण चाहता है: हस्ताक्षरित वेबहुक, घुमाने योग्य रहस्य, विदेशी ब्रांड न गिराने वाले client-safe त्रुटि। मासिक USD 1,000+ के पास सहसंबंध ID और रीप्ले साक्ष्य वाणिज्यिक समीक्षा सामग्री बनते हैं। लॉन्च पर वेबहुक और कुंजियाँ और लॉन्च के बाद टिकने वाले वेबहुक से जोड़ें।.

बिना हस्ताक्षर callback घटना नहीं

व्यापार फ़ील्ड पार्स करने से पहले हस्ताक्षर जाँचें। गायब, बासी या बेमेल हस्ताक्षर client-safe त्रुटि से अस्वीकार करें — «पायलट के लिए फिर भी प्रोसेस» न करें। जाँच छोड़ने वाला staging उपभोक्ता उत्पादन को छोड़ना सिखाता है। संदेश कैटलॉग live का अर्थ यह नहीं कि वेबहुक URL सार्वजनिक कूड़ा है। शरीर पर किसने हस्ताक्षर किया सिद्ध न कर सकें तो घटना नहीं, जाली अनुरोध है।.

रीप्ले विंडो और 02:00 क्यों होता है

कम-से-कम-एक बार डिलीवरी timeout, 5xx और अस्पष्ट नेटवर्क हानि पर पुनःप्रयास करती है। 02:00 का देर retry सामान्य है। विंडो सीमित करती है हस्ताक्षरित पेलोड कितनी देर स्वीकार्य रहे: बहुत चौड़ी तो हमलावर पुराना STOP दोहराए; बहुत संकरी तो वैध retry जालसाजी लगे। विंडो अस्वीकार हस्ताक्षर विफलता से अलग लॉग करें। इनबाउंड वेबहुक रीट्राई देखें। तेज़ उत्तर दें, पहले persist करें, async प्रोसेस करें — ACK से पहले CRM करने वाला हैंडलर डुप्लिकेट बनाता है।.

वित्त पढ़ सके ऐसी idempotency

वही घटना ID वही अंत स्थिति दे। प्लेटफ़ॉर्म घटना/संदेश ID निकालें — टाइमस्टैम्प प्लस शरीर से कुंजी न गढ़ें। ज्ञात ID पर बिना दोबारा डेबिट सफलता लौटाएँ। आउटबाउंड भेज को वही अनुशासन चाहिए — आइडेम्पोटेंसी, रीट्राई और पैसा। वित्त हर prepaid पंक्ति स्थिति घटना के विरुद्ध समझाए। timeout क्लाइंट retry तूफ़ान लाए तो लेजर पहले नुकसान दिखाए। कैटलॉग in setup idempotency «Live तक» छोड़ने का बहाना नहीं।.

दोहरी स्वीकृति अराजकता के बिना हस्ताक्षर घुमाव

पुराने और नए हस्ताक्षर हमेशा स्वीकार वाले विंडो के बिना रहस्य घुमाएँ। ओवरलैप योजना करें, फिर काटें। उत्पादन रहस्य टिकट में न चिपकाएँ। सैंडबॉक्स और उत्पादन उपभोक्ता अलग रखें। असफल उपभोक्ता को दूसरा डेबिट गढ़े बिना फिर चला सकें, इसके लिए dead-letter व रीप्ले औजार रखें। सहसंबंध ID भेज से लेजर पंक्ति तक ले जाएँ ताकि 02:00 पुरातत्व नहीं runbook हो।.

खतरे के संकेत

हैंडलर बिना हस्ताक्षर शरीर «अभी के लिए» स्वीकार करता है
रीप्ले विंडो नहीं, या हफ्तों में मापी
टाइमस्टैम्प तुलना बिना स्थिति ओवरराइट
ACK से पहले CRM/ईमेल दुष्प्रभाव
उत्पादन रहस्य चैट में
पिछले महीने डुप्लिकेट घटना ID कोई नहीं देखता
ग्राहक त्रुटियाँ कच्चे अपस्ट्रीम कोड गिराती हैं

IOSOR के साथ शुरुआत करें

अपना IOSOR कंसोल खोलें और इनबाउंड डिलीवरी रसीद और इवेंट कॉलबैक के लिए अपनी सक्रिय वेबहुक एंडपॉइंट सेटिंग की जाँच करें। पाँच मिनट की एक सख्त सिग्नेचर सत्यापन रीप्ले विंडो सेट करें और अपने हैंडलर को पूरी तरह से प्लेटफॉर्म इवेंट आईडी से बाइंड करें। डुप्लिकेट पेलोड को बिना किसी अतिरिक्त व्यावसायिक तर्क को ट्रिगर किए 200 OK लौटाना सुनिश्चित करने के लिए स्टेजिंग में रीप्ले किए गए पेलोड के विरुद्ध अपने एंडपॉइंट का परीक्षण करें।

IOSOR सार

अपुष्ट वेबहुक हैंडलर और अनुपस्थित रीप्ले विंडो नियमित नेटवर्क रिट्राई को सुरक्षा जोखिमों में बदल देते हैं। सिग्नेचर वैधता को UTC टाइमस्टैम्प द्वारा सीमित करना और सख्त आइडपोटेंसी लागू करना यह सुनिश्चित करता है कि 02:00 बजे के स्वचालित डिलीवरी प्रयास सुरक्षित रहें। डेवलपर्स को कंसोल में कच्चा पेलोड सत्यापित करना चाहिए, लेजर में प्रोसेस हो चुके इवेंट दर्ज करने चाहिए और निर्यात से पहले सही स्टेटस कोड लौटाना चाहिए।

क्या यह गाइड मददगार थी?