মূল কনটেন্টে যান
লাইভ ডেমো
ব্লগ

বুকিং ইঞ্জিন API ত্রুটি সামলানো: টাকা খরচ করানো তিনটি ব্যর্থতা

Tekravel সম্পাদকীয়
AI-এর সহায়তায় লেখা

বৃহস্পতিবার সন্ধ্যায় একটি সাপোর্ট টিকিট আসে। গ্রাহক টাকা দিয়েছেন, পেজ ঘুরতে থাকল, তারপর একটি সাধারণ ত্রুটি দেখাল। কার্ড থেকে টাকা কাটা হয়ে গেছে। আপনার লগে সরবরাহকারীর কাছে একটি POST দেখা যাচ্ছে, যার কোনো উত্তর আসেনি। এয়ারলাইন কি আসন ধরে রেখেছে? কেউ বলতে পারছে না, আর গ্রাহক অপেক্ষা করছেন। ভালো বুকিং ইঞ্জিন API ত্রুটি সামলানো মূলত এমন কাজ যাতে আপনাকে কখনও সেই অবস্থানে পড়তেই না হয়, অথবা পড়লে অন্তত ঠিক কী করতে হবে তা জানা থাকে।

বেশির ভাগ ইন্টিগ্রেশন গাইড ত্রুটিকে স্ট্যাটাস কোডের তালিকা হিসেবে দেখে। বুকিংয়ে কোডগুলোই সহজ অংশ। টাকা খরচ করায় কয়েকটি অল্প পরিস্থিতি, যেখানে অনুরোধ ব্যর্থ মনে হলেও বাস্তবে কিছু বদলে গেছে, অথবা সফল মনে হলেও বাস্তবে কিছু বদলায়নি। এর মধ্যে তিনটি বাকিগুলোর চেয়ে বেশি গুরুত্বপূর্ণ।

প্রথম ব্যর্থতা: সার্চ আর বুকিংয়ের মাঝে দাম নড়ে গেল

সার্চের ফলাফল একটি কোটেশন, চুক্তি নয়। ভাড়া ক্যাশ করা থাকে, ইনভেন্টরি সরবরাহকারীর বিক্রির সব চ্যানেলে ভাগ হয়, আর ১৪:০২-এ আপনি যে সংখ্যা দেখিয়েছেন তা কয়েক মিনিট পরেই পুরোনো হয়ে যেতে পারে। সরবরাহকারী আপনাকে জানায় create-booking ধাপে, কখনও পরিষ্কার "fare changed" উত্তরে, কখনও আপাতদৃষ্টিতে সফল উত্তরের ভেতরে চুপচাপ ভিন্ন মোট অঙ্ক ফেরত দিয়ে।

দ্বিতীয় ধরনটাই বিপজ্জনক। আপনার কোড যদি নিশ্চিতকরণ পড়ে, বুকিং সংরক্ষণ করে এবং গ্রাহকের দেখা অঙ্কই চার্জ করে, তাহলে পার্থক্যটা যায় আপনার মার্জিন থেকে, অথবা পরে একটি ADM হয়ে। তাই নিয়মটা সহজ: পেমেন্ট ক্যাপচার করার আগে প্রতিবার, কোডের ভেতরে, সরবরাহকারীর নিশ্চিত করা মোট অঙ্ক গ্রাহকের গ্রহণ করা মোট অঙ্কের সঙ্গে মিলিয়ে দেখুন।

অমিল হলে কী করবেন তা নির্ভর করে ব্যবধানের আকার এবং কে তা বহন করবে তার ওপর। মুদ্রার মধ্যে কয়েক সেন্টের রাউন্ডিং এমন সহনসীমা যা একবারই ঠিক করে রাখা যায়। এর চেয়ে বড় কিছু হলে সেটি স্পষ্ট "গ্রহণ করুন" বোতামসহ নতুন দাম হিসেবে গ্রাহকের কাছে ফিরে যায়। কখনও স্বয়ংক্রিয়ভাবে নিজে বহন করবেন না, আর কখনও স্বয়ংক্রিয়ভাবে বাড়তি চার্জও করবেন না।

দ্বিতীয় ব্যর্থতা: বুক হয়েছে, কিন্তু টিকিট ইস্যু হয়নি

PNR থাকা আর টিকিট থাকা এক জিনিস নয়। অনেক ফ্লো আগে রিজার্ভেশন তৈরি করে, তারপর আলাদা ধাপে e-ticket ইস্যু করে, মাঝখানে একটি সময়সীমা থাকে। পেমেন্ট সফল হলে আর ইস্যু ব্যর্থ হলে আপনি গ্রাহকের টাকা এবং এমন একটি রিজার্ভেশন ধরে আছেন যা নিজের ঘড়ি ধরে মেয়াদ শেষ হবে।

এই ব্যর্থতা খুব কমই শব্দ করে। issue কল একটি ত্রুটি বা টাইমআউট ফেরত দেয়, আর বুকিং এমন অবস্থায় পড়ে থাকে যা আপনার ডাটাবেস "paid" লিখে রাখে, অথচ সরবরাহকারী এখনও "held" বলছে। এর মধ্যে টিকিটিং সময়সীমা চলতে থাকে, এবং আপনার সাপোর্ট কিউয়ের মতো নয়, এয়ারলাইন অপেক্ষা করে না।

এটিকে সফলতা বা ব্যর্থতার রকমফের নয়, আলাদা একটি স্টেট হিসেবে সামলান। একটি বুকিংয়ের অন্তত এই স্টেটগুলো দরকার: created, held, payment captured, issuing, ticketed, failed-and-refundable। "Payment captured, issuing" এমন স্টেট যার টাইমার দরকার: বুকিং সেখানে বেশি সময় থাকলে একটি জব সরবরাহকারীর কাছ থেকে রিজার্ভেশন আবার পড়ে সিদ্ধান্ত নেবে, কোনো মানুষ খেয়াল করার অপেক্ষায় থাকবে না। সরবরাহকারীর সময়সীমা জানা থাকলে সিদ্ধান্তটা সস্তা, কারণ টাকা ফেরত দেওয়ার আগে কতক্ষণ নিরাপদে পুনরায় চেষ্টা করা যায় সেটি তাতে জানা যায়।

তৃতীয় ব্যর্থতা: অজানা ফলাফলের টাইমআউট

এটাই সেই বৃহস্পতিবার সন্ধ্যার টিকিট। আপনার অনুরোধ বেরিয়ে গেছে, কোনো উত্তর ফেরেনি, সংযোগ ছিঁড়ে গেছে বা গেটওয়ে হাল ছেড়েছে। সরবরাহকারী হয়তো পুরোপুরি, আংশিক, অথবা একেবারেই প্রক্রিয়া করেনি।

লোভ হলো আবার চেষ্টা করা। create-booking কল অন্ধভাবে রিট্রাই করবেন না, কারণ দ্বিতীয় চেষ্টা দ্বিতীয় একটি রিজার্ভেশন তৈরি করতে পারে, আর ডুপ্লিকেট একটি প্রকৃত খরচ: দুটি আসন ধরা, হয়তো দুটি টিকিট ইস্যু, এবং একটিতে রিফান্ড নিয়ে ঝামেলা।

নিরাপদ ক্রম হলো: থামুন, পড়ুন, তারপর সিদ্ধান্ত নিন। গ্রাহকের দিকের ফ্লো থামান একটি সৎ স্টেট দিয়ে: "আমরা আপনার বুকিং নিশ্চিত করছি"। সরবরাহকারীর দিকটা পড়ুন কলের আগে আপনার তৈরি রেফারেন্স দিয়ে বুকিং খুঁজে (এ কারণেই আপনি আগে নিজের ক্লায়েন্ট রেফারেন্স বানান এবং সরবরাহকারী নিলে সেটি সঙ্গে পাঠান)। তারপরই সিদ্ধান্ত: পাওয়া গেলে প্রকৃত অবস্থা থেকে চালিয়ে যান; সরবরাহকারীর নিজস্ব প্রক্রিয়াকরণ-সময়ের পরেও না পাওয়া গেলে একবার রিট্রাই করা নিরাপদ।

সরবরাহকারী যদি আপনার রেফারেন্স দিয়ে খোঁজার উপায় না দেয়, তাহলে সংকীর্ণ সময়ের ভেতরে যাত্রীর নাম, রুট ও তারিখ দিয়ে খুঁজুন এবং মিলে যাওয়াকে পাওয়া গেছে ধরুন। দেখতে কুৎসিত, কিন্তু ডুপ্লিকেটের চেয়ে অনেক সস্তা।

একটি সিদ্ধান্ত-টেবিল, যার সঙ্গে আপনি দ্বিমত করতে পারেন

আপনি যা দেখছেনআপনি যা জানেনযা করবেনযা করবেন না
সরবরাহকারী "fare changed" ফেরত দিলকিছুই বুক হয়নিনতুন মোট অঙ্ক দেখান, সম্মতি নিন, create আবার চালানপুরোনো দামে আবার চালিয়ে আশা করা যে পার হবে
সফল, কিন্তু মোট অঙ্ক গ্রাহকের গ্রহণ করা অঙ্কের চেয়ে আলাদানতুন দামে একটি বুকিং আছেপেমেন্ট ধরে রাখুন, গ্রাহককে জিজ্ঞেস করুন, তিনি না চাইলে বুকিং void করুনপুরোনো অঙ্ক ক্যাপচার করে পার্থক্য নিজে সামলানো
পেমেন্ট ক্যাপচার হয়েছে, issue কলে ত্রুটিPNR আছে, টিকিটের অবস্থা অজানারিজার্ভেশন আবার পড়ুন, সময়সীমার ভেতরে issue রিট্রাই করুন, তারপর রিফান্ডবুকিংকে ব্যর্থ চিহ্নিত করে PNR ভুলে যাওয়া
create-এ টাইমআউটফলাফল অজানাআপনার রেফারেন্স দিয়ে খুঁজুন, তারপর চালান বা একবার রিট্রাই করুনসঙ্গে সঙ্গে অন্ধ রিট্রাই
cancel-এ টাইমআউটসেগমেন্টের দায় আপনার ওপর থাকতে পারেগ্রাহককে কিছু বলার আগে স্ট্যাটাস আবার পড়ুনবোতাম চাপা হয়েছে বলে "cancelled" দেখানো

একটি সারি নিয়ে আপনি তর্ক করতে পারেন: কিছু দল গ্রাহককে শান্ত রাখতে প্রথম ইস্যু ত্রুটিতেই রিফান্ড করে। সস্তা টিকিটে সেটি সমর্থনযোগ্য, দামি টিকিটে খারাপ অভ্যাস, কারণ এক মিনিট পরেই যে ভাড়া বাঁচানো যেত তা হারাতে পারেন।

ভুল করলে কত খরচ

প্রতিটি ব্যর্থতার বিল আলাদা। ধরা না পড়া দাম বদল মানে প্রভাবিত প্রতিটি বুকিংয়ে মার্জিন হারানো, প্রায়ই রিকনসিলিয়েশনের আগে কেউ টের পায় না। booked-not-ticketed মানে গ্রাহক বিমানবন্দরে পৌঁছান মেয়াদোত্তীর্ণ রিজার্ভেশন ও কার্ডে কাটা টাকা নিয়ে, যা একই সঙ্গে চার্জব্যাক ও সুনামের সমস্যা। টাইমআউটে অন্ধ রিট্রাই মানে ডুপ্লিকেট রিজার্ভেশন, আর এয়ারলাইন ডুপ্লিকেট অডিট করে; এমন ঘটনার ধারা শেষ পর্যন্ত ADM-এ গিয়ে ঠেকে।

এর কোনোটাই অচেনা কিছু নয়। এটা সেই অনাকর্ষণীয় প্লাম্বিংয়ের কাজ, যা একটি ডেমোকে এমন কিছু থেকে আলাদা করে যা আপনি পুরো সপ্তাহান্ত চলতে দিতে পারেন।

দরকার পড়ার আগেই রিকনসিলিয়েশন জব বানান

তিনটি ব্যর্থতাই একই জায়গায় শেষ হয়: আপনার ডাটাবেস আর সরবরাহকারীরটা একমত নয়। তাই প্রথম ঘটনার আগেই দুটি তুলনা করার জব লিখুন, পরে নয়। রাতে একবার চালানো ন্যূনতম; যা কিছু অন্তর্বর্তী অবস্থায় আছে তার জন্য কয়েক মিনিট পরপর আরও ভালো। এটি held, issuing বা unknown-এ আটকে থাকা বুকিংগুলোর তালিকা করে, সরবরাহকারীকে জিজ্ঞেস করে, তারপর রেকর্ড ঠিক করে বা প্রমাণসহ একটি টিকিট খোলে।

বুকিং কলের প্রতিটি রিকোয়েস্ট ও রেসপন্স, টাইমআউটসহ, আপনার পাঠানো রেফারেন্সের সঙ্গে সংরক্ষণ করুন। গ্রাহক কোনো চার্জ নিয়ে আপত্তি তুললে ওই লগই আপনার যুক্তি। এটি লেটেন্সি নিয়ে আলোচনাকেও সৎ রাখে: টাইমআউট কেন নির্মূল করার মতো বাগ নয় বরং জীবনের বাস্তবতা, তা বুঝতে দেখুন API লেটেন্সি নিয়ে আপনি কী ঠিক করতে পারেন আর কী পারেন না।

সরবরাহকারীর সংযোগ নিজে কীভাবে জুড়বেন তা এখনও ঠিক করতে থাকলে ফ্লাইট বুকিং API ইন্টিগ্রেশন-এর ওয়াকথ্রু এই লেখার ধরে নেওয়া কলের ক্রম আলোচনা করে। আর এই স্টেটগুলো আমাদের ফ্লাইট ও হোটেল API-তে কীভাবে মেলে তা নিয়ে কথা বলতে চাইলে, অ্যাক্সেস শুরু হয় একটি আলাপ দিয়ে: ট্রাভেল API পেজ দেখুন।

Tekravel সম্পাদকীয়

ট্রাভেল টেকনোলজি ডেস্ক

Tekravel-এর ট্রাভেল টেকনোলজি ডেস্ক লেখে ইন্ডাস্ট্রির জন্য: এজেন্সি মালিক, কনসলিডেটর এবং যেসব ডেভেলপার তাঁদের সংযুক্ত করেন। প্রতিটি লেখা প্রকাশের আগে সেই প্ল্যাটফর্মেই যাচাই করা হয় যেটির কথা সেখানে বলা হয়েছে।