संग्रहण (कब्जा करना) आसान लेकिन अंतिम रूप देना कठिन क्यों है? (Why Payment Capture Is Easy But Finalization Is Hard)

एक कदम, छह कदम

जब आप कहते हैं "भुगतान प्राप्त हुआ" तो आपका आमतौर पर एक मतलब होता है: प्रदाता गेटवे ने पीएसपी को एक अनुरोध भेजा और पीएसपी ने कहा "मुझे पैसा प्राप्त हुआ"। यह एक कॉल, एक उत्तर, एक पुष्टिकरण है। लेकिन जब आप कहते हैं कि "ऑर्डर पूरा हो गया" तो आपका मतलब बहुत बड़ा है: स्टॉक काट लिया गया है, वित्तीय रिकॉर्ड खोला गया है, ऑर्डर की पुष्टि की गई है, ग्राहक को सूचित किया गया है, टोकरी साफ़ कर दी गई है और किसी भी वफादारी बिंदु पर कार्रवाई की गई है।```text Capture: Checkout Orchestrator → Provider Gateway → PSP → “alındı”

Finalization: Stok düş + Finans kaydı + Sipariş onayı + Bildirim + Sepet temizliği (altı bağımsız adım, altısı da ayrı ayrı başarısız olabilir)

## पहले उल्लेख पर अवधारणाएँ```text
📦 Capture
PSP'nin, önceden ayrılmış veya doğrudan istenmiş bir tutarı fiilen tahsil ettiğini bildirmesi; tek bir dış sistem gerçeğidir.

📦 Finalization
Capture'dan sonra işin gerçekten bitmesi için gereken tüm iç adımların toplamı: stok, finans, onay, bildirim, temizlik.

📦 Saga
Birden fazla adımı, her biri kendi başarısızlık ve telafi mantığıyla, uçtan uca yöneten bir iş akışı deseni.

📦 Telafi Adımı (Compensating Action)
Bir saga adımı geri alınamadığında, önceki adımların etkisini dengelemek için çalıştırılan ters işlem.

📦 Adım İşaretçisi (Step Marker)
Bir saga adımının tamamlandığını kalıcı olarak işaretleyen kayıt; yeniden çalıştığında adımın tekrarlanmasını önler.
```कैप्चर की आसानी इस तथ्य से आती है कि यह एक एकल प्रतिभागी (पीएसपी) और एक प्रतिक्रिया पर निर्भर करता है। अंतिम रूप देने में कठिनाई इस तथ्य से आती है कि यह बड़ी संख्या में प्रतिभागियों पर निर्भर करता है जो स्वतंत्र रूप से असफल हो सकते हैं।

## कैप्चर सरल क्यों है

सफलता के लिए कैप्चर की कसौटी एक वाक्य है: क्या पीएसपी ने कहा "मैंने इसे एकत्र किया" या नहीं? यह जानकारी एक समकालिक प्रतिक्रिया या वेबहुक के साथ आती है, इसके हस्ताक्षर सत्यापित होते हैं, और प्रासंगिक भुगतान रिकॉर्ड `Captured` बन जाता है। यहां एकाधिक डेटाबेस में कोई लेखन नहीं है, कोई एकाधिक सेवा कॉल नहीं है, कोई अन्योन्याश्रित अनुक्रमिक चरण नहीं हैं - बाहरी सिस्टम से हां/नहीं में उत्तर मिलता है।```text
Provider Gateway --istek--> PSP
Provider Gateway <--"captured"-- PSP
                        ↓
                Payment.Status = Captured
                (bir yazma, bir karar)
```## अंतिम रूप देना एक गाथा क्यों है

एक बार कब्जा हो जाने के बाद, काम खत्म नहीं होता है; असली जटिल हिस्सा अब शुरू होता है। किसी आदेश को "वास्तव में समाप्त" माने जाने के लिए, निम्नलिखित सभी चरण विश्वसनीय रूप से, किसी भी क्रम में होने चाहिए, जब तक कि वे सभी पूरे न हो जाएं:```text
Finalization Saga
  1. Stok Servisi'nde rezervasyonu kesin düşüşe çevir
  2. Finans/Ledger'da gelir kaydını aç
  3. Sipariş satırlarını “onaylandı” olarak işaretle
  4. Müşteriye bildirim gönder
  5. Sepeti/aktif intent'i temizle
  6. (Varsa) sadakat puanı veya kampanya etkisini işle
```इन छह चरणों में से प्रत्येक का अपना त्रुटि पैटर्न है: इन्वेंट्री सेवा अस्थायी रूप से अनुपलब्ध हो सकती है, वित्त सेवा एक सत्यापन त्रुटि उत्पन्न कर सकती है, अधिसूचना सेवा का समय समाप्त हो सकता है। कैप्चर में केवल एक "हाँ/नहीं" था; यहां छह स्वतंत्र "हां/नहीं" हैं, और उनमें से कोई भी दूसरे की गारंटी नहीं देता है।

## आंशिक रूप से अंतिम रूप देना: सबसे खतरनाक मध्यवर्ती अवस्था

सबसे कठिन स्थिति तब होती है जब गाथा का आधा हिस्सा काम करता है और आधा नहीं। उदाहरण के लिए, स्टॉक कम हो गया लेकिन वित्तीय रिकॉर्ड नहीं खोला जा सका; सिस्टम क्रैश हो गया और पुनः आरंभ होने पर कार्यकर्ता को यह जानना होगा कि कौन से चरण पूरे हो चुके हैं।```text
Finalization saga çalışıyor
  ✓ Stok düşüldü
  ✓ Sipariş onaylandı
  ✗ Finans kaydı — worker crash oldu
  ? Bildirim — henüz denenmedi

Worker yeniden başlar: Hangi adımları TEKRAR çalıştırmalı, hangilerini ATLAMALI?
```आप चरण चिह्नकों के बिना इस प्रश्न का उत्तर नहीं दे सकते। प्रत्येक चरण को अपनी पूर्णता स्थिति को स्थायी रूप से दर्ज करना होगा; अन्यथा, जब कार्यकर्ता पुनरारंभ करता है, तो यह या तो शुरुआत से पूरी गाथा चलाएगा और स्टॉक को दोगुना कर देगा, या यह कुछ नहीं करेगा और ऑर्डर हमेशा के लिए अधूरा रहेगा।

## इस भेद को हल्के में क्यों लिया जाता है

जब अधिकांश टीमें "भुगतान एकीकरण" कहती हैं तो उनका मतलब केवल कैप्चर करना और इसे साप्ताहिक कार्य के रूप में नियोजित करना होता है। फ़ाइनलाइज़ेशन गाथा को आम तौर पर "विवरण" के रूप में देखा जाता है और पर्याप्त रूप से डिज़ाइन किए बिना उत्पादन में चला जाता है। वास्तव में, कैप्चर एक बाहरी सिस्टम से बात कर रहा है, जैसा कि हमने इस श्रृंखला के पहले दो भागों में दिखाया है; अंतिम रूप देने के लिए आपके अपने सिस्टम को अपनी त्रुटियों के प्रति लचीला होना आवश्यक है। उत्तरार्द्ध के लिए बहुत बड़े इंजीनियरिंग निवेश की आवश्यकता होती है।

## इस एपिसोड में सबसे भ्रमित करने वाला मैचअप```text
❌ Ödeme entegrasyonu = Capture'ı çalıştırmak
✓ Ödeme entegrasyonu = Capture + finalization saga'sının tamamı

❌ Capture başarılı olduysa iş bitmiştir
✓ Capture, finalization saga'sının başlangıç tetikleyicisidir, bitişi değil

❌ Saga adımlarının sırası önemli değildir, hepsi “aynı işlem”dir
✓ Her adım bağımsız başarısız olabilir; her birinin kendi retry ve telafi mantığı gerekir

❌ Worker crash olursa saga'yı baştan çalıştırmak güvenlidir
✓ Adım işaretçisi olmadan baştan çalıştırmak, tamamlanmış adımları tekrarlayıp yan etki üretir

आपकी अंतिम गाथा के परीक्षण की सूची

1. अपनी अंतिमकरण गाथा में चरण लिखें: कितने चरण हैं, कौन से चरण व्यक्तिगत सेवाओं पर जाते हैं?
2. परीक्षण करें कि क्या प्रत्येक चरण अपने आप में निष्क्रिय है: यदि आप एक ही चरण को दो बार चलाते हैं तो क्या परिणाम बदल जाता है?
3. गाथा (अराजकता परीक्षण) के बीच में जानबूझकर कार्यकर्ता को मार डालो। जब वह दोबारा शुरू करता है, तो वह कौन से कदम छोड़ता है और कौन से कदम दोहराता है?
4. क्या प्रत्येक चरण में विफलता परिदृश्य के लिए मुआवजा या पुनः प्रयास की योजना है, या यह इस धारणा के साथ लिखा गया है कि "यह कदम हमेशा सफल होगा"?
5. यदि कैप्चर सफल है लेकिन अंतिम रूप देने की गाथा कभी शुरू नहीं हुई है, तो इसे महसूस करने में कितने मिनट लगेंगे?

यदि आप इन पांच परीक्षणों में से दो में असफल हो जाते हैं, तो आपकी अंतिमकरण गाथा संभवतः "खुशहाल पथ" के लिए लिखी गई थी, न कि त्रुटि पथ के लिए।

इस अनुभाग से याद रखने योग्य बातें

1. कैप्चर एकल बाहरी सिस्टम (पीएसपी) से हां/नहीं में उत्तर है; यहीं से इसकी सरलता आती है।
2. अंतिम रूप देना एक ऐसी गाथा है जिसे पूरा करने के लिए कई स्वतंत्र चरणों की आवश्यकता होती है; कठिनाई यहीं से आती है।
3. आंशिक अंतिमीकरण (कुछ चरण ठीक हैं, कुछ नहीं) सबसे खतरनाक मध्यवर्ती स्थिति है और इसे चरण संकेतकों के बिना सुरक्षित रूप से पुनर्प्राप्त नहीं किया जा सकता है।
4. यदि "भुगतान एकीकरण" केवल कैप्चर को कवर करता है, तो परियोजना का सबसे जोखिम भरा हिस्सा योजना से बाहर छोड़ दिया जाता है।

कैप्चर वह क्षण है जब पीएसपी आपसे सहमत होता है। अंतिम रूप तब दिया जाता है जब आप अपने सिस्टम के साथ समझौता कर लेते हैं - और यह आमतौर पर सबसे कठिन हिस्सा होता है।