कैसे पक्का करेंगे कि कोई payment webhook किसी ग्राहक से दो बार पैसे न ले या उसे दो बार provision न करे?

delivery को at least once मानिए और handler को idempotent बनाइए। पहले signature जांचिए, फिर provider के event id को unique constraint के पीछे रखिए और अगर उसे पहले देख चुके हैं तो तुरंत 200 लौटा दीजिए। state का बदलाव और id का insert एक ही transaction में कीजिए ताकि crash उसे आधा लागू न कर सके। धीमा काम queue में डालकर handler तेज़ रखिए, और जब आप सच में फेल हों तो provider को दोबारा भेजने दीजिए।

मैं इस धारणा से शुरू करता हूं कि provider वही event एक से ज़्यादा बार, बेतरतीब क्रम में, और कभी कभी घंटों देर से भेजेगा, क्योंकि तीनों होते हैं। तो handler पहले signature और timestamp जांचता है, फिर provider के event id को एक unique index वाली processed_events table में insert करता है। अगर वह insert conflict करता है तो हम इसे संभाल चुके हैं, और मैं दोबारा काम करने की जगह सीधे 200 लौटा देता हूं। अहम बारीकी यह है कि वह insert और असली असर, यानी subscription देना या payment दर्ज करना, एक ही transaction में होते हैं, ताकि बीच में मरता हुआ process एक को दूसरे के बिना न छोड़ जाए। कोई भी धीमी चीज़, जैसे receipt का email भेजना, अपनी idempotency key के साथ queue पर जाती है। मैं event का timestamp भी रखता हूं और उस event को अनदेखा करता हूं जो मेरे पास पहले से मौजूद हालत से पुराना है, और यही आपको तब बचाता है जब cancellation उस upgrade से पहले आ जाए जो उससे पहले हुआ था। नाकामी पर मैं जानबूझकर 500 लौटाता हूं ताकि provider दोबारा भेजे, और कोई event dead letter queue में गिरे तो alert करता हूं।