डुплиकेट वेबहुक से दूसरा डेबिट नहीं होना चाहिए

कम से कम एक बार डिलीवरी पुनः प्रयास करेगी। एक डुप्लीकेट वेबहुक जो दूसरा डेबिट या दूसरी इनबॉक्स लाइन पोस्ट करता है, वह धन और संचालन की घटना है, न कि हानिरहित एसीके। यह पृष्ठ विफलता पथ है: प्रीपेड राशि और इनबॉक्स पर पुनः प्रयास और रिप्ले इempotent रहते हैं — एपीआई सेंड-इempotency निबंध नहीं और इनबाउंड एसएमएस पुनः प्रयास प्लेबुक नहीं।

संबंधित: हस्ताक्षर और रीप्ले विंडो गेट, पहले भेजने से पहले वेबहुक अनुबंध, डेबिट पंक्ति बनाम डिलीवरी स्थिति एक ही ledger पर।

IOSOR व्हाइट-लेबल प्रीपेड है। USD 20 एक उपभोक्ता पर डुप्लीकेट-इवेंट स्मोक को निधि देता है; USD 1,000/माह के पास सॉफ्ट समीक्षा पुनः प्रयास को नए शुल्क के रूप में मूल्य देती है। ग्राहक केवल व्हाइट-लेबल इवेंट आईडी देखते हैं।

इempotency एक विफलता पथ है, कोई नारा नहीं

सुखी पथ: एक हस्ताक्षरित घटना, एक स्वीकार, एक डेबिट। विफलता पथ विश्वास जलाता है — टाइमआउट, 5xx, प्रदाता रीप्ले, ऑपरेटर री-पुश। साइड इफ़ेक्ट लेज़र, इनबॉक्स और CRM से पहले पहले भेजने से पहले वेबहुक अनुबंध से इempotency कुंजी संग्रहीत करें। सॉफ्ट USD 1,000/माह एसीके और नई कुंजी के आविष्कार को वॉल्यूम ऋण मानता है; USD 20 साबित करता है कि एक जबरन रिप्ले कभी भी पैसे को दोगुना नहीं करता है।

क्या डुप्लीकेट के रूप में गिना जाता है

हस्ताक्षर और रीप्ले विंडो गेट प्रामाणिकता और ताजगी तय करता है। यह पृष्ठ वैध डुप्लीकेट के बाद होने वाली घटनाओं का मालिक है: एक अंतिम स्थिति, एक धन रेखा, एक इनबॉक्स लाइन।

पैसा दो बार नहीं हिलना चाहिए

एक ही इवेंट आईडी के लिए दूसरा डेबिट एक बग है, भले ही उत्पाद अभी भी डिलीवर दिखाता है। वित्त टीम यूटीसी विंडो के लिए एक प्रीपेड पंक्ति देखती है। एसीके के बाद आंशिक साइड इफेक्ट्स — पहले CRM, बाद में लेज़र — दोहरा सच बनाते हैं। यदि पर्सिस्ट के बाद प्रोसेसिंग विफल हो जाती है, तो उसी कुंजी पर वर्कर को पुनः प्रयास करें।

इनबॉक्स भी दोगुना नहीं होना चाहिए

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

डुप्लीकेट-सुरक्षित वेबहुक के लिए खरीदार चेकलिस्ट

लेज़र को छूने से पहले हस्ताक्षर और हेडर को सत्यापित करें। रेस कंडीशन को रोकने के लिए डेटाबेस में इवेंट आईडी को लॉक करें। सफल प्रसंस्करण के बाद हमेशा 2xx लौटाएं लेकिन कभी भी दूसरा डेबिट न लिखें। निगरानी प्रणाली को डुप्लीकेट घटनाओं की तुरंत रिपोर्ट करनी चाहिए।

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

पहले से कट चुके गलियारे पर खिड़की के भीतर एक हस्ताक्षरित पुनःप्रेषण जबरदस्ती करें। event id को ledger id के पास निर्यात करें और एक debit पंक्ति व एक inbox पंक्ति सिद्ध करें। दूसरी कट दिखे तो उस उपभोक्ता को रोकें और अतिरिक्त पंक्ति लौटाएँ — बाद के यातायात से नेट न करें। यह पुनःप्रेषण धन का द्वार है, E.164 जाँच या शिपिंग वाक्य नहीं।

IOSOR सार

पुनःप्रेषण नई भेज नहीं। एक event id एक debit लिखती है।

करें: हस्ताक्षर और खिड़की चालू रखें, खिड़की में POST के बाद एक debit सिद्ध करें। न करें: हर POST काटें, या नेटवर्क पुनःप्रयास को दूसरा बिल मानें।