অ্যাকাউন্টের মালিকানাধীন মেসেজিং ব্র্যান্ড ব্যবহার করুন
অনুমোদিত উৎস আইপি থেকে HTTPS-এর মাধ্যমে একটি সক্রিয় API অ্যাকাউন্ট ব্যবহার করুন। Basic ও Bearer প্রমাণীকরণ সমর্থিত। ব্র্যান্ড আইডিটি অবশ্যই সেই অ্যাকাউন্টের হতে হবে। প্রদানকারীর টোকেন, ব্র্যান্ডের পরিচয়সংক্রান্ত তথ্য ও ফেরত পাওয়া প্রতিবেদন গোপন রাখুন।
নতুন বাহ্যিক যাচাইয়ের অর্ডার দিন
এই ব্র্যান্ডের জন্য যাচাই প্রদানকারীকে দিয়ে নতুন যাচাই করাতে হলে POST ব্যবহার করুন। প্রদানকারীর ফলাফল আগে থেকেই থাকলে তার পরিবর্তে আমদানি ব্যবহার করুন। এর থেকে পৃথক প্রক্রিয়া হলো ব্র্যান্ডের পরিচয় পুনরায় যাচাই।
প্রথমে ব্র্যান্ডের বর্তমান তথ্য পড়ে পরিচয়সংক্রান্ত তথ্য নিশ্চিত করুন। সমর্থিত প্রদানকারী/শ্রেণি বেছে নিতে দেখুন বর্তমান তালিকাগুলো এবং সেই প্রদানকারীর শর্তাবলি পরীক্ষা করুন। সব প্রদানকারী সব শ্রেণি সমর্থন করে না। রাজনৈতিক যাচাইয়ের অতিরিক্ত বিবরণে প্রকৃত সংগঠন বা প্রচারাভিযানের তথ্য দিতে হবে, নমুনা তথ্য নয়।
প্রদানকারীর জন্য অনুরোধ প্রস্তুত করুন
| ক্ষেত্র | মান |
|---|---|
| evpId | বাহ্যিক যাচাই প্রদানকারীদের বর্তমান তালিকা থেকে নেওয়া আবশ্যিক প্রদানকারী আইডি, 1–10 অক্ষরের। |
| vettingClass | আপনি যে সমর্থিত শ্রেণি কিনতে চান; সেটি স্পষ্টভাবে নির্বাচন করুন এবং তার মূল্য নিশ্চিত করুন। |
| additionalRequestPayload | প্রদানকারীনির্দিষ্ট বিবরণসহ JSON-এ এনকোড করা একটি স্ট্রিং, যা রাজনৈতিক যাচাইয়ের জন্য আবশ্যক। এটি বাইরের JSON অবজেক্টের ভেতরে থাকা একটি স্ট্রিং, ভেতরে বসানো আরেকটি অবজেক্ট নয়। নির্বাচিত প্রদানকারীর সঙ্গে সব আবশ্যিক বিবরণ নিশ্চিত করুন। |
সফল ও ব্যর্থ ফলাফলের চার্জ নিশ্চিত করুন
মার্কিন ডলারে বর্তমান খুচরা ফি, যা অক্টোবর 24, 2026 তারিখে দেখা হয়েছে। বাস্তব অর্ডার দেওয়ার আগে বর্তমান পরিমাণ নিশ্চিত করুন। সফল ফলাফলের মূল্যের বিপরীতে অগ্রিম জমা অর্থের পর্যাপ্ততা যাচাই করা হয়; কেনাকাটার সুবিধা সক্রিয় থাকতে হবে।
| শ্রেণি | সক্রিয় ফলাফল | ব্যর্থ ফলাফল |
|---|---|---|
| STANDARD | $46.12 | $5.56 |
| ENHANCED | $112.78 | $6.67 |
| POLITICAL | $73.34 | $24.45 |
| Express অনুরোধসহ POLITICAL | $106.67 | $24.45 |
| AUTHPLUS | $13.89 | $13.89 |
| RCS | $83.34 | $83.34 |
অপেক্ষমাণ অর্ডারের সফল/ব্যর্থ ফলাফলের জন্য নির্ধারিত অর্থের পরিমাণ অপরিবর্তিত থাকে এবং ACTIVE বা FAILED ফলাফল সমন্বিত হলে তার হিসাব নিষ্পত্তি হয়। শেষের দুটি শ্রেণিতে উভয় চূড়ান্ত ফলাফলের জন্য একই নির্ধারিত ফি প্রযোজ্য। তাৎক্ষণিক চূড়ান্ত ফলাফল পাওয়া গেলে অর্ডারের উত্তর দেওয়ার সময়ই চার্জ নেওয়া হতে পারে। পরে অবস্থা সমন্বয় করার সময় অপেক্ষমাণ চার্জ নিষ্পত্তি হতে পারে।
বিনামূল্যে বাহ্যিক যাচাইয়ের নিশ্চয়তা হিসেবে mock:true ব্যবহার করবেন না। বাহ্যিক যাচাইয়ের বর্তমান নিষ্পত্তি প্রক্রিয়ায় সেই অর্ডার তবুও নথিভুক্ত হতে পারে এবং তার জন্য চার্জ নেওয়া হতে পারে। এই নির্দেশনা অনুযায়ী পরীক্ষা করতে বাস্তবে কিছু কেনার প্রয়োজন নেই; অর্থপ্রদেয় যাচাই অনুমোদনের ইচ্ছা না হওয়া পর্যন্ত অফলাইন পরীক্ষার পূর্বপ্রস্তুত ডেটা ব্যবহার করুন।
পর্যালোচনা করা একটি অর্ডার জমা দিন
প্রদানকারীর আইডি, শ্রেণি ও প্রয়োজনীয় অতিরিক্ত তথ্য দিয়ে vetting-order.json প্রস্তুত করুন। ফাইলটিতে আপনি যে অনুরোধটি বাস্তবে পাঠাতে চান সেটিই থাকে। এটি গোপন রাখুন।
curl --silent --show-error --fail-with-body --user "$API_USER:$API_PASSWORD" \
--request POST \
--header 'Content-Type: application/json' \
--header "Idempotency-Key: $IDEMPOTENCY_KEY" \
--data-binary @vetting-order.json \
"https://api.multitel.net/tcr/v2/brand/$BRAND_ID/externalVetting"প্রকৃত ফলাফলের অগ্রগতি দেখুন
সফল HTTP উত্তরে অপেক্ষমাণ যাচাইয়ের রেকর্ড থাকতে পারে। তার vettingId সংরক্ষণ করুন এবং উপলব্ধ তথ্য অনুযায়ী vettingStatus, কারণ, স্কোর ও কার্যকর হওয়ার/মেয়াদ শেষ হওয়ার তারিখ পরীক্ষা করুন। PENDING ও UNSCORE হলে আরও খোঁজ নিতে হবে; ACTIVE, FAILED ও EXPIRED আলাদা ফলাফল নির্দেশ করে। শুধু HTTP গ্রহণযোগ্যতা অনুকূল স্কোর বা প্রচারাভিযানের যোগ্যতা প্রমাণ করে না।
রেকর্ডের অগ্রগতি দেখতে বাহ্যিক যাচাইয়ের অবস্থা ব্যবহার করুন। চূড়ান্ত ফলাফল পড়া বা আমদানি করার ফলে আগের কোনো অর্থপ্রদেয় অর্ডারের হিসাব নিষ্পত্তি হতে পারে; এতে বিদ্যমান বকেয়া চার্জ আর প্রযোজ্য হবে না, এমন নিশ্চয়তা নেই।
একই অভিপ্রেত অনুরোধ আবার পাঠান
প্রতিটি অভিপ্রেত কার্যক্রমের জন্য একটি Idempotency-Key ব্যবহার করুন এবং মেথড, পাথ, কোয়েরি ও বডির বাইট হুবহু সংরক্ষণ করুন। কীতে স্পেস ছাড়া 1–128টি মুদ্রণযোগ্য ASCII অক্ষর ব্যবহার করা যায়। চলমান অনুরোধের অনুলিপির উত্তরে Retry-After-সহ 409 আসতে পারে। সম্পন্ন অনুরোধের ক্ষেত্রে ত্রুটিসহ সংরক্ষিত উত্তরই আবার ফেরত দেওয়া হয়। অনুরোধের হারসীমা মেনে চলুন।
যোগাযোগ পরিবহনে ব্যর্থতার পর ক্যাশে সংরক্ষিত 502 পাওয়া যেতে পারে। requestId-সহ ক্যাশে সংরক্ষিত 500 বোঝাতে পারে যে রেজিস্ট্রি কার্যক্রমটি গ্রহণ করেছে, কিন্তু স্থানীয়ভাবে স্থায়ী সংরক্ষণ বা বিলিং ব্যর্থ হয়েছে। অনুরোধের আইডি সংরক্ষণ করুন, বর্তমান রেকর্ড পরীক্ষা করুন এবং নতুন কী ব্যবহারের আগে সহায়তা দলের সঙ্গে মিলিয়ে বিষয়টি নিষ্পত্তি করুন। ত্রুটি হয়েছে মানেই কোনো অর্ডার নেই, এমন ধরে নেবেন না।