API ইনভয়েস সপ্তাহ: আইডেম্পোটেন্সি গ্যাপ যা ডুপ্লিকেট ডেবিট ঘটায়

ইনভয়েস সপ্তাহের সেটেলমেন্ট মেকানিক্স

উচ্চ ভলিউমের ইনভয়েস সপ্তাহের প্রক্রিয়াকরণের সময়, অতিরিক্ত কনকারেন্সি সূক্ষ্ম আইডেম্পোটেন্সি গ্যাপ প্রকাশ করতে পারে। যখন বিলিং ইঞ্জিনগুলো বাল্ক SMS এবং ভয়েস ব্যবহার প্রসেস করে, তখন নিখোঁজ বা দুর্বল কি-এর কারণে ডুপ্লিকেট ডেবিট ট্রিগার হতে পারে। একদম সঠিক লেজার ইন্টিগ্রিটি বজায় রাখার জন্য গ্রাহকের ব্যালেন্সে কোনো চার্জ পোস্ট করার আগে কঠোর কি-ভ্যালিডেশন প্রয়োজন। নিরাপদ অর্থ পরিচালনার মৌলিক প্যাটার্নগুলোর জন্য «আইডেম্পোটেন্সি, পুনঃচেষ্টা ও অর্থ» পর্যালোচনা করুন।

রিট্রাই ঝড় এবং নেটওয়ার্ক টাইমআউট

নেটওয়ার্কের সমস্যার কারণে প্রায়শই API ক্লায়েন্টরা বিলিং সমাপ্তির জন্য POST রিকোয়েস্ট পুনরায় পাঠায়। যদি আপনার ব্যাকএন্ডে রিকোয়েস্ট ডুপ্লিকেশন প্রতিরোধ ব্যবস্থা না থাকে, তবে একটি ড্রপড TCP ACK এর ফলে ডাবল প্রসেসিং ঘটে। প্রিপেইড ব্যালেন্স ব্যবহারকারী প্রতিটি প্ল্যাটফর্ম মাইক্রো-স্পাইকের সময় নেগেটিভ ইকুইটি রোধ করতে USD 20 প্রিপেইড ফ্লোর কার্যকর করে। যখন ট্রানজ্যাকশন ভলিউম প্রতি মাসে USD 1,000 এর কাছাকাছি রিভিউ লেভেলে পৌঁছায়, তখন আমাদের স্বয়ংক্রিয় ঝুঁকি নিয়ন্ত্রণ নিশ্চিত করে যে রিট্রাই লুপগুলো মূল লেজার স্টেট পরিবর্তন করে না।

কি-এর স্কোপ এবং রিকোয়েস্ট লাইফসাইকেল

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

কনকারেন্ট লেজার রাইট হ্যান্ডলিং

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

কনকারেন্সি হ্যান্ডেল করার জন্য লেজার ডাটাবেসে অ্যাটমিক ট্রানজ্যাকশন ব্যবহার করা হয়। এর অর্থ হলো অ্যাকাউন্টের টাকা কাটা এবং ট্রানজ্যাকশন রেকর্ড করা একটি একক অপারেশন হিসেবে কার্যকর হয়। যদি একটি অংশ ব্যর্থ হয়, তবে পুরো প্রসেস রোলব্যাক হয়।.

স্যান্ডবক্স এনভায়রনমেন্টে গ্যাপিং টেস্ট

ত্রুটি হ্যান্ডলিং যাচাই করার জন্য নন-প্রোডাকশন পরিবেশে নেটওয়ার্ক পার্টিশন এবং বিলম্বিত Webhook সিমুলেট করা প্রয়োজন। ট্রায়াল সেটআপ থেকে লাইভ অপারেশনে নিরাপদে যাওয়ার জন্য সাবধানে ক্রেডেনশিয়াল হ্যান্ডেল করতে হয়, যেমনটি «স্যান্ডবক্স থেকে প্রোডাকশন কাটওভার»-এ বিস্তারিত বর্ণনা করা হয়েছে। আপনার ক্লায়েন্ট ডুপ্লিকেট সাবমিশন প্রত্যাখ্যান সঠিকভাবে হ্যান্ডেল করে কিনা তা নিশ্চিত করতে সবসময় HTTP 409 কনফ্লিক্ট রেসপন্স টেস্ট করুন।

IOSOR API আর্কিটেকচার দিয়ে শুরু করুন

গত সপ্তাহের ইনভয়েস prepaid ledger-এর পাশে খুলুন। প্রতিটি debit সারিতে সেই Idempotency-Key খুঁজুন যা তাকে তৈরি করেছে। চাবিহীন সারি — বা একই চাবি দুই অঙ্কে — নিষ্পত্তির ফাঁক। ব্যবধানকে নতুন চাহিদা ধরে পরিশোধের আগে সেই সারিগুলো আসল অভিপ্রায়ের সঙ্গে মিলিয়ে নিন।

IOSOR সারাংশ

করুন: ইনভয়েস সপ্তাহ চাবি-সারি মিল হিসেবে বন্ধ করুন। একই অভিপ্রায় আবার ছাপানো রিট্রাই ঝড় একটি debit, নতুন ইনভয়েস সারি নয়।

করবেন না: অর্থ বিভাগ পাঠানোর কনসোলের চেয়ে বেশি সারি দেখেছে বলে ফাঁককে তাজা ভলিউম ধরে পরিশোধ করবেন না। চাবিহীন বাড়তি সারি দ্বৈত নিষ্পত্তি, প্রবৃদ্ধি নয়।