بکنگ انجن API کی غلطیوں کا انتظام: تین خرابیاں جو پیسے ضائع کرتی ہیں

سپورٹ ٹکٹ جمعرات کی شام آتا ہے۔ ایک کسٹمر نے ادائیگی کی، صفحہ گھومتا رہا، پھر ایک عمومی غلطی دکھائی۔ کارڈ سے رقم کٹ گئی۔ آپ کے لاگز میں سپلائر کو بھیجا گیا ایک POST نظر آتا ہے جس کا جواب کبھی نہیں آیا۔ کیا ایئرلائن نے سیٹ روک رکھی ہے؟ کوئی نہیں بتا سکتا، اور کسٹمر انتظار میں ہے۔ اچھا بکنگ انجن API کی غلطیوں کا انتظام زیادہ تر اس کام کا نام ہے کہ آپ کبھی اس حالت میں نہ پہنچیں، یا کم از کم پہنچنے پر ٹھیک ٹھیک جانتے ہوں کہ کیا کرنا ہے۔
انٹیگریشن کی زیادہ تر گائیڈز غلطیوں کو اسٹیٹس کوڈز کی فہرست سمجھتی ہیں۔ بکنگ میں کوڈز آسان حصہ ہیں۔ پیسے ان چند صورتوں میں ضائع ہوتے ہیں جہاں درخواست ناکام دکھائی دیتی ہے مگر دنیا پھر بھی بدل چکی ہوتی ہے، یا کامیاب دکھائی دیتی ہے مگر دنیا نہیں بدلی۔ ان میں سے تین باقیوں سے زیادہ اہم ہیں۔
پہلی خرابی: سرچ اور بکنگ کے درمیان قیمت بدل گئی
سرچ کے نتائج ایک قیمت کا اندازہ ہیں، معاہدہ نہیں۔ کرایے کیش ہوتے ہیں، نشستیں ان تمام چینلز میں مشترک ہیں جن سے سپلائر بیچتا ہے، اور جو رقم آپ نے 14:02 پر دکھائی وہ چند منٹ بعد پرانی ہو سکتی ہے۔ سپلائر آپ کو بکنگ بنانے کے مرحلے پر بتاتا ہے، کبھی صاف «کرایہ بدل گیا» جواب سے، کبھی بصورتِ دیگر کامیاب جواب کے اندر خاموشی سے مختلف کل رقم لوٹا کر۔
دوسری قسم خطرناک ہے۔ اگر آپ کا کوڈ تصدیق پڑھ کر بکنگ محفوظ کر لے اور کسٹمر سے وہی رقم لے جو اس نے دیکھی تھی، تو فرق آپ کے مارجن سے نکلتا ہے، یا بعد میں ADM سے۔ اصول سادہ ہے: سپلائر کی تصدیق شدہ کل رقم کا کسٹمر کی قبول کردہ کل رقم سے ہر بار، کوڈ میں، ادائیگی وصول کرنے سے پہلے موازنہ کریں۔
فرق ہونے پر کیا کرنا ہے، یہ فرق کے سائز اور اسے برداشت کرنے والے پر منحصر ہے۔ کرنسیوں کے درمیان چند پیسوں کی راؤنڈنگ ایسی رواداری ہے جو آپ ایک بار طے کرتے ہیں۔ اس سے بڑی کوئی بھی چیز کسٹمر کے پاس نئی قیمت کے طور پر، واضح قبولیت کے بٹن کے ساتھ جاتی ہے۔ اسے کبھی خودکار طور پر نہ پی جائیں، اور کبھی خودکار طور پر وصول نہ کریں۔
دوسری خرابی: بک ہو گئی، مگر ٹکٹ جاری نہیں ہوا
PNR کا موجود ہونا ٹکٹ کے موجود ہونے کے برابر نہیں۔ بہت سے فلو پہلے ریزرویشن بناتے ہیں اور ای ٹکٹ الگ مرحلے میں جاری کرتے ہیں، دونوں کے بیچ وقت کی حد ہوتی ہے۔ اگر ادائیگی کامیاب ہو اور اجرا ناکام، تو آپ کے پاس کسٹمر کی رقم ہے اور ایک ریزرویشن جو اپنی گھڑی پر ختم ہو جائے گی۔
یہ خرابی شاذ ہی شور مچاتی ہے۔ اجرا کی کال غلطی یا ٹائم آؤٹ لوٹاتی ہے، اور بکنگ ایسی حالت میں بیٹھی رہتی ہے جسے آپ کا ڈیٹا بیس «ادا شدہ» کہتا ہے جبکہ سپلائر اب بھی «روکی ہوئی» کہتا ہے۔ اس دوران ٹکٹنگ کی مدت چلتی رہتی ہے، اور آپ کی سپورٹ قطار کے برعکس ایئرلائن انتظار نہیں کرتی۔
اسے کامیابی یا ناکامی کی قسم نہیں بلکہ الگ حالت کے طور پر سنبھالیں۔ بکنگ کو کم از کم یہ حالتیں چاہییں: بنائی گئی، روکی گئی، ادائیگی وصول، اجرا جاری، ٹکٹ جاری، ناکام-اور-قابلِ واپسی۔ «ادائیگی وصول، اجرا جاری» وہ حالت ہے جسے ٹائمر چاہیے: جب کوئی بکنگ وہاں بہت دیر رہے تو ایک جاب کو انسان کے نوٹس کرنے کا انتظار کیے بغیر سپلائر سے ریزرویشن دوبارہ پڑھ کر فیصلہ کرنا چاہیے۔ سپلائر کی وقت کی حد معلوم ہو تو فیصلہ سستا ہے، کیونکہ وہ بتاتی ہے کہ رقم لوٹانے سے پہلے آپ کتنی دیر محفوظ طریقے سے دوبارہ کوشش کر سکتے ہیں۔
تیسری خرابی: نامعلوم نتیجے والا ٹائم آؤٹ
یہ جمعرات شام والا ٹکٹ ہے۔ آپ کی درخواست نکلی؛ جواب نہیں آیا؛ کنکشن ٹوٹ گیا یا گیٹ وے نے ہار مان لی۔ سپلائر نے اسے مکمل، جزوی یا بالکل پروسیس نہیں کیا ہو سکتا ہے۔
دوبارہ کوشش کی ترغیب ہوتی ہے۔ بکنگ بنانے کی کال کو آنکھیں بند کر کے دہرائیں نہیں، کیونکہ دوسری کوشش دوسری ریزرویشن بنا سکتی ہے، اور نقل ایک حقیقی لاگت ہے: دو سیٹیں روکی گئیں، شاید دو ٹکٹ جاری ہوئے، ایک پر ریفنڈ کا جھگڑا۔
محفوظ ترتیب یہ ہے: رکیں، پڑھیں، پھر فیصلہ کریں۔ کسٹمر کے فلو کو ایماندار حالت «ہم آپ کی بکنگ کی تصدیق کر رہے ہیں» کے ساتھ روک دیں۔ سپلائر کی طرف وہ ریفرنس استعمال کر کے پڑھیں جو آپ نے کال سے پہلے خود بنایا تھا (اسی لیے آپ پہلے اپنا کلائنٹ ریفرنس بناتے ہیں اور سپلائر قبول کرے تو بھیجتے ہیں)۔ اس کے بعد ہی فیصلہ کریں: مل گئی تو حقیقی حالت سے آگے بڑھیں؛ سپلائر کی اپنی پروسیسنگ ونڈو کے بعد بھی نہ ملی تو ایک بار دوبارہ کوشش محفوظ ہے۔
اگر سپلائر آپ کے ریفرنس سے تلاش کی سہولت نہیں دیتا تو مسافر کے نام، روٹ اور تاریخ سے تنگ ونڈو میں تلاش کریں اور مماثلت کو ملی ہوئی سمجھیں۔ بدصورت ہے، مگر نقل سے کہیں سستا۔
فیصلے کا جدول جس سے آپ اختلاف کر سکتے ہیں
| آپ کیا دیکھتے ہیں | آپ کیا جانتے ہیں | کیا کریں | کیا نہ کریں |
|---|---|---|---|
| سپلائر «کرایہ بدل گیا» لوٹاتا ہے | کچھ بک نہیں ہوا | نئی کل رقم دکھائیں، قبولیت مانگیں، تخلیق دوبارہ چلائیں | پرانی قیمت پر اس امید میں دوبارہ چلانا کہ چل جائے |
| کامیابی، مگر کل رقم کسٹمر کی قبول کردہ سے مختلف | نئی قیمت پر بکنگ موجود ہے | ادائیگی روکیں، کسٹمر سے پوچھیں، انکار پر بکنگ منسوخ کریں | پرانی رقم وصول کر کے فرق پی جانا |
| ادائیگی وصول، اجرا کی کال میں غلطی | PNR موجود ہے، ٹکٹ کی حالت نامعلوم | ریزرویشن دوبارہ پڑھیں، حد کے اندر اجرا دہرائیں، اس کے بعد رقم لوٹائیں | بکنگ کو ناکام نشان زد کر کے PNR بھول جانا |
| تخلیق پر ٹائم آؤٹ | نتیجہ نامعلوم | اپنے ریفرنس سے تلاش کریں، پھر آگے بڑھیں یا ایک بار دہرائیں | فوراً اندھا دہرانا |
| منسوخی پر ٹائم آؤٹ | آپ اب بھی سیگمنٹ کے ذمہ دار ہو سکتے ہیں | کسٹمر کو کچھ کہنے سے پہلے حالت دوبارہ پڑھیں | کلک ہونے کی وجہ سے «منسوخ» دکھانا |
ایک سطر جس سے آپ اختلاف کر سکتے ہیں: کچھ ٹیمیں کسٹمر کو پرسکون رکھنے کے لیے اجرا کی پہلی غلطی پر رقم لوٹا دیتی ہیں۔ سستے ٹکٹوں میں یہ قابلِ دفاع ہے اور مہنگے ٹکٹوں میں بری عادت، کیونکہ آپ ایسا کرایہ کھو سکتے ہیں جو ایک منٹ بعد بچایا جا سکتا تھا۔
غلطی کی قیمت کیا ہے
ہر خرابی کا بل الگ ہے۔ نظر انداز ہوئی قیمت کی تبدیلی ہر متاثرہ بکنگ پر کھویا ہوا مارجن ہے، جو اکثر مصالحت کے وقت ہی پکڑا جاتا ہے۔ بک-مگر-ٹکٹ-نہیں والا معاملہ ایسا کسٹمر ہے جو ایئرپورٹ پر ختم شدہ ریزرویشن اور کارڈ پر کٹی ہوئی رقم کے ساتھ پہنچتا ہے: ایک ہی وقت میں چارج بیک اور ساکھ کا مسئلہ۔ ٹائم آؤٹ کے بعد اندھی دوبارہ کوشش نقلی ریزرویشن ہے، اور ایئرلائنز نقلوں کا آڈٹ کرتی ہیں؛ ان کا ایک سلسلہ ADM تک پہنچنے والی چیز ہے۔
ان میں سے کچھ بھی انوکھا نہیں۔ یہ بے رونق پلمبنگ ہے جو ایک ڈیمو کو اس چیز سے الگ کرتی ہے جسے آپ ہفتہ وار چھٹی پر چلتا چھوڑ سکیں۔
مصالحتی جاب ضرورت پڑنے سے پہلے بنائیں
تینوں خرابیاں ایک ہی طرح ختم ہوتی ہیں: آپ کا ڈیٹا بیس اور سپلائر کا ڈیٹا بیس متفق نہیں ہوتے۔ اس لیے وہ جاب لکھیں جو انہیں ملاتا ہے، پہلے واقعے سے پہلے، بعد میں نہیں۔ رات کی ایک رن کم از کم ہے؛ عبوری حالت میں موجود ہر چیز کے لیے ہر چند منٹ بہتر ہے۔ یہ روکی گئی، اجرا میں، یا نامعلوم حالت میں پھنسی بکنگز کی فہرست بناتا ہے، سپلائر سے پوچھتا ہے کہ وہ کیا سمجھتا ہے، اور یا تو ریکارڈ درست کرتا ہے یا ثبوت کے ساتھ ٹکٹ کھولتا ہے۔
بکنگ کالز کی ہر درخواست اور جواب، ٹائم آؤٹس سمیت، بھیجے گئے ریفرنس کے ساتھ محفوظ رکھیں۔ جب کسٹمر کٹوتی پر اعتراض کرے تو وہی لاگ آپ کی دلیل ہے۔ یہ تاخیر کی گفتگو کو بھی ایماندار رکھتا ہے: یہ سمجھنے کے لیے کہ ٹائم آؤٹ زندگی کی حقیقت ہیں، مٹانے والی بگ نہیں، API کی تاخیر میں آپ کیا ٹھیک کر سکتے ہیں اور کیا نہیں دیکھیں۔
اگر آپ ابھی سپلائر کنکشن کو جوڑنے کا طریقہ طے کر رہے ہیں تو فلائٹ بکنگ API انٹیگریشن کی گائیڈ اس مضمون کی فرض کردہ کالز کی ترتیب بیان کرتی ہے۔ اور اگر آپ بات کرنا چاہتے ہیں کہ یہ حالتیں ہماری فلائٹ اور ہوٹل APIs پر کیسے منطبق ہوتی ہیں تو رسائی گفتگو سے شروع ہوتی ہے: ٹریول API کا صفحہ دیکھیں۔