برانڈ کی بیرونی جانچ کا آرڈر دیں

اکاؤنٹ کی ملکیت والا پیغام رسانی کا برانڈ استعمال کریں

کسی مجاز ماخذ کے آئی پی پتے سے HTTPS کے ذریعے فعال API اکاؤنٹ استعمال کریں۔ Basic اور Bearer توثیق کی سہولت موجود ہے۔ برانڈ کا شناختی نمبر اسی اکاؤنٹ سے تعلق رکھنا چاہیے۔ فراہم کنندہ کے ٹوکن، برانڈ کی شناختی معلومات اور موصول ہونے والی رپورٹیں نجی رکھیں۔

نئی بیرونی جانچ کا آرڈر دیں

جب آپ چاہتے ہوں کہ جانچ فراہم کنندہ اس برانڈ کی نئی جانچ کرے تو POST استعمال کریں۔ اگر فراہم کنندہ کا نتیجہ پہلے سے موجود ہے تو اس کے بجائے درآمد استعمال کریں۔ یہ عمل الگ ہے اس عمل سے جس کا نام ہے برانڈ کی شناخت کی دوبارہ تصدیق۔

پہلے برانڈ کا موجودہ ریکارڈ پڑھیں اور اس کی شناختی معلومات کی تصدیق کریں۔ معاون فراہم کنندہ اور جانچ کی قسم منتخب کرنے کے لیے رجوع کریں: موجودہ فہرستیں، اور اس فراہم کنندہ کی ضروریات دیکھیں۔ ہر فراہم کنندہ ہر قسم کی جانچ کی سہولت نہیں دیتا۔ سیاسی جانچ کی اضافی تفصیلات میں اصل تنظیم یا مہم کی وضاحت ہونی چاہیے، نمونے کا ڈیٹا نہیں۔

فراہم کنندہ کے لیے درخواست تیار کریں

کامیابی اور ناکامی کے چارجز کی تصدیق کریں

امریکی ڈالر میں موجودہ خوردہ فیس، جو 24 اکتوبر 2026 کو دیکھی گئی تھی۔ حقیقی آرڈر دینے سے پہلے موجودہ رقم کی تصدیق کریں۔ پیشگی ادا کردہ رقم کو کامیابی کی قیمت کے مقابلے میں جانچا جاتا ہے؛ خریداری کی سہولت فعال ہونا لازمی ہے۔

زیر التوا آرڈرز میں کامیابی اور ناکامی کی رقوم برقرار رہتی ہیں، اور 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 جواب کا مطلب یہ ہو سکتا ہے کہ رجسٹری نے کارروائی قبول کر لی، لیکن مقامی طور پر ڈیٹا مستقل محفوظ کرنے یا بلنگ میں ناکامی ہوئی۔ درخواست کا شناختی نمبر محفوظ رکھیں، موجودہ ریکارڈ دیکھیں اور نئی کلید استعمال کرنے سے پہلے معاونت کی ٹیم سے صورت حال کی تصدیق اور تصفیہ کریں۔ یہ فرض نہ کریں کہ خرابی کا مطلب کسی آرڈر کا موجود نہ ہونا ہے۔