बुकिंग इंजन API एरर हैंडलिंग: तीन विफलताएँ जो पैसे खाती हैं

गुरुवार की शाम सपोर्ट टिकट आता है। ग्राहक ने भुगतान किया, पेज घूमता रहा, फिर एक सामान्य एरर दिखा। कार्ड से पैसे कट चुके हैं। आपके लॉग में सप्लायर को भेजा गया एक POST है जिसका जवाब कभी नहीं आया। क्या एयरलाइन ने सीट होल्ड की? कोई नहीं बता सकता, और ग्राहक इंतज़ार कर रहा है। अच्छा बुकिंग इंजन API एरर हैंडलिंग ज़्यादातर इसी काम का नाम है कि आप कभी उस स्थिति में न पहुँचें, या कम से कम पहुँचने पर ठीक-ठीक जानें कि क्या करना है।
ज़्यादातर इंटीग्रेशन गाइड एरर को स्टेटस कोड की सूची की तरह देखते हैं। बुकिंग में कोड आसान हिस्सा हैं। पैसा उन गिनी-चुनी स्थितियों में डूबता है जहाँ रिक्वेस्ट असफल दिखती है पर दुनिया फिर भी बदल जाती है, या सफल दिखती है पर कुछ नहीं बदला। इनमें से तीन बाकी सब से ज़्यादा मायने रखती हैं।
पहली विफलता: सर्च और बुकिंग के बीच कीमत बदल गई
सर्च रिज़ल्ट एक कोटेशन है, अनुबंध नहीं। फेयर कैश होते हैं, इन्वेंटरी सप्लायर के सभी चैनलों में साझा होती है, और कुछ मिनट पहले दिखाया गया आँकड़ा अब पुराना हो सकता है। सप्लायर यह बुकिंग बनाने के चरण पर बताता है, कभी साफ़ "फेयर बदल गया" जवाब से, कभी बाहर से सफल दिखते जवाब में चुपचाप दूसरा कुल लौटाकर।
दूसरा प्रकार ख़तरनाक है। अगर आपका कोड कन्फ़र्मेशन पढ़कर बुकिंग सेव कर दे और ग्राहक से वही रकम काटे जो उसने देखी थी, तो अंतर आपके मार्जिन से जाता है, या बाद में किसी ADM से। इसलिए नियम सीधा है: भुगतान कैप्चर करने से पहले, हर बार, कोड में, सप्लायर द्वारा पुष्ट कुल को ग्राहक द्वारा स्वीकार किए गए कुल से मिलाइए।
अंतर होने पर क्या करना है, यह उसके आकार और उसे कौन उठाएगा, इस पर निर्भर है। मुद्राओं के बीच कुछ पैसों की राउंडिंग एक सहनसीमा है जो एक बार तय होती है। इससे बड़ा कुछ भी नई कीमत और स्पष्ट "स्वीकार करें" बटन के साथ ग्राहक के पास लौटता है। उसे कभी अपने-आप न सोखें, कभी अपने-आप न वसूलें।
दूसरी विफलता: बुक हुआ, पर टिकट जारी नहीं हुआ
PNR का होना टिकट का होना नहीं है। कई फ़्लो पहले रिज़र्वेशन बनाते हैं और ई-टिकट एक अलग चरण में जारी करते हैं, दोनों के बीच समय-सीमा के साथ। अगर भुगतान सफल हो और इश्यू विफल, तो आपके पास ग्राहक का पैसा है और एक रिज़र्वेशन जो अपनी घड़ी से समाप्त होगा।
यह विफलता शायद ही कभी शोर करती है। इश्यू कॉल एरर या टाइमआउट लौटाती है, और बुकिंग ऐसी स्थिति में पड़ी रहती है जिसे आपका डेटाबेस "भुगतान हुआ" कहता है जबकि सप्लायर अब भी "होल्ड" कहता है। इस बीच टिकटिंग की समय-सीमा चलती रहती है, और आपकी सपोर्ट कतार के उलट एयरलाइन इंतज़ार नहीं करती।
इसे सफलता या विफलता का रूपांतर नहीं, बल्कि अपनी अलग स्थिति मानिए। बुकिंग को कम से कम ये स्थितियाँ चाहिए: बनी, होल्ड, भुगतान कैप्चर, इश्यू हो रहा है, टिकट जारी, असफल और रिफ़ंड योग्य। "भुगतान कैप्चर, इश्यू हो रहा है" को टाइमर चाहिए: अगर बुकिंग वहाँ बहुत देर रुकी रहे, तो एक जॉब को सप्लायर से रिज़र्वेशन दोबारा पढ़कर फ़ैसला करना चाहिए, किसी इंसान के ध्यान देने का इंतज़ार नहीं। सप्लायर की समय-सीमा पता हो तो फ़ैसला सस्ता होता है, क्योंकि वह बताती है कि रिफ़ंड से पहले कितनी देर सुरक्षित ढंग से दोबारा कोशिश कर सकते हैं।
तीसरी विफलता: टाइमआउट, नतीजा अज्ञात
यह वही गुरुवार शाम का टिकट है। आपकी रिक्वेस्ट निकल गई; जवाब नहीं लौटा; कनेक्शन टूट गया या गेटवे ने हार मान ली। सप्लायर ने उसे पूरा, आंशिक या बिल्कुल प्रोसेस नहीं किया हो सकता है।
लालच रीट्राई का होता है। बुकिंग बनाने वाली कॉल को आँख मूँदकर दोबारा न भेजें, क्योंकि दूसरी कोशिश दूसरा रिज़र्वेशन बना सकती है, और डुप्लिकेट की असली क़ीमत है: दो सीटें होल्ड, शायद दो टिकट जारी, और एक पर रिफ़ंड का झगड़ा।
सुरक्षित क्रम है: रुकें, पढ़ें, फिर तय करें। ग्राहक वाले फ़्लो को "हम आपकी बुकिंग की पुष्टि कर रहे हैं" जैसी ईमानदार स्थिति में रोक दें। कॉल से पहले आपने जो रेफ़रेंस बनाया था, उससे बुकिंग खोजकर सप्लायर की तरफ़ पढ़ें (इसीलिए पहले अपना क्लाइंट रेफ़रेंस बनाते हैं और सप्लायर स्वीकारे तो साथ भेजते हैं)। उसके बाद ही तय करें: मिल गई तो असली स्थिति से आगे बढ़ें; सप्लायर की प्रोसेसिंग विंडो के बाद भी न मिली तो एक बार दोबारा कोशिश सुरक्षित है।
अगर सप्लायर आपके रेफ़रेंस से खोजने नहीं देता, तो संकरी समय-विंडो में यात्री के नाम, रूट और तारीख़ से खोजिए और मिलान को "मिल गई" मानिए। भद्दा है, पर डुप्लिकेट से कहीं सस्ता।
निर्णय तालिका जिससे आप असहमत हो सकते हैं
| आप क्या देखते हैं | आप क्या जानते हैं | क्या करें | क्या न करें |
|---|---|---|---|
| सप्लायर "फेयर बदल गया" लौटाता है | कुछ बुक नहीं हुआ | नया कुल दिखाएँ, सहमति लें, क्रिएट दोबारा चलाएँ | पुरानी कीमत से दोबारा भेजकर उम्मीद करना |
| सफलता, पर कुल ग्राहक की स्वीकृत रकम से अलग | नई कीमत पर बुकिंग मौजूद है | भुगतान रोकें, ग्राहक से पूछें, मना करे तो बुकिंग रद्द करें | पुरानी रकम कैप्चर कर अंतर खुद झेलना |
| भुगतान कैप्चर, इश्यू कॉल में एरर | PNR मौजूद, टिकट की स्थिति अज्ञात | रिज़र्वेशन दोबारा पढ़ें, समय-सीमा में इश्यू फिर आज़माएँ, उसके बाद रिफ़ंड | बुकिंग को असफल चिह्नित कर PNR भूल जाना |
| क्रिएट पर टाइमआउट | नतीजा अज्ञात | अपने रेफ़रेंस से खोजें, फिर आगे बढ़ें या एक बार रीट्राई करें | तुरंत आँख मूँदकर रीट्राई |
| कैंसल पर टाइमआउट | सेगमेंट की ज़िम्मेदारी अब भी आपकी हो सकती है | ग्राहक को कुछ कहने से पहले स्थिति दोबारा पढ़ें | क्लिक हुआ इसलिए "रद्द" दिखा देना |
एक पंक्ति पर आप बहस कर सकते हैं: कुछ टीमें ग्राहक को शांत रखने के लिए पहली इश्यू एरर पर ही रिफ़ंड कर देती हैं। सस्ते टिकटों पर यह उचित है और महँगे टिकटों पर बुरी आदत, क्योंकि आप ऐसा फेयर खो सकते हैं जो एक मिनट बाद बचाया जा सकता था।
ग़लती करने पर आपको क्या क़ीमत चुकानी पड़ती है
हर विफलता का बिल अलग है। छूटा हुआ मूल्य-परिवर्तन हर प्रभावित बुकिंग पर खोया मार्जिन है, जो अक्सर मिलान तक पता नहीं चलता। बुक-पर-टिकट-नहीं वाला मामला वह ग्राहक है जो एयरपोर्ट पर समाप्त हो चुके रिज़र्वेशन और कार्ड पर कटी रकम के साथ पहुँचता है, यानी चार्जबैक और साख की समस्या एक साथ। टाइमआउट पर आँख मूँदकर रीट्राई डुप्लिकेट रिज़र्वेशन है, और एयरलाइनें डुप्लिकेट का ऑडिट करती हैं; उनका पैटर्न ADM में बदल जाता है।
इनमें से कुछ भी असाधारण नहीं है। यह वही अनाकर्षक प्लंबिंग है जो डेमो को ऐसी चीज़ से अलग करती है जिसे आप पूरे सप्ताहांत चलता छोड़ सकते हैं।
ज़रूरत पड़ने से पहले मिलान जॉब बनाइए
तीनों विफलताएँ एक ही तरह ख़त्म होती हैं: आपका डेटाबेस और सप्लायर का रिकॉर्ड असहमत होते हैं। इसलिए दोनों की तुलना करने वाला जॉब पहली घटना से पहले लिखिए, बाद में नहीं। रात में एक बार चलाना न्यूनतम है; बीच की स्थिति वाली हर चीज़ के लिए हर कुछ मिनट पर बेहतर है। वह होल्ड, इश्यू हो रहा है या अज्ञात में अटकी बुकिंग सूचीबद्ध करता है, सप्लायर से पूछता है, और या तो रिकॉर्ड सुधारता है या सबूत के साथ टिकट खोलता है।
बुकिंग कॉल की हर रिक्वेस्ट और रिस्पॉन्स, टाइमआउट समेत, भेजे गए रेफ़रेंस के साथ सहेजिए। जब ग्राहक किसी चार्ज पर आपत्ति करे, वह लॉग आपकी दलील है। यह लेटेंसी की बहस को भी ईमानदार रखता है: API लेटेंसी में आप क्या ठीक कर सकते हैं और क्या नहीं पढ़कर समझिए कि टाइमआउट जीवन का तथ्य क्यों हैं, मिटाया जाने वाला बग क्यों नहीं।
अगर आप अभी तय कर रहे हैं कि सप्लायर कनेक्शन कैसे जोड़ें, तो फ़्लाइट बुकिंग API इंटीग्रेशन गाइड उस कॉल-क्रम को समझाती है जो यह लेख मानकर चलता है। और अगर आप चर्चा करना चाहते हैं कि ये स्थितियाँ हमारी फ़्लाइट और होटल API से कैसे मेल खाती हैं, तो पहुँच बातचीत से शुरू होती है: ट्रैवल API पेज देखें।