# Launch خریداری مدت اور اکاؤنٹ SDK حد

یہ تبدیلی صرف مقامی ترقی اور توثیق میں ہوئی؛ Launch تعینات یا SDK پیکیج شائع نہیں ہوا۔ موجودہ سورس Licentivo اکاؤنٹ اجازت پروٹوکول اور متعلقہ سرکاری SDK اپ ڈیٹ پر منحصر ہے؛ صرف طویل مدتی لائسنس کلید معاون پرانے سرور کے ساتھ نہیں ملایا جا سکتا۔

## ذمہ داریاں

| صلاحیت | ذمہ دار فریق |
| --- | --- |
| رجسٹریشن، لاگ ان، اکاؤنٹ سیکیورٹی، پروڈکٹ، آرڈر، ادائیگی، واپسی | Launch |
| تجدید/اپ گریڈ کوٹ، خریداری سائیکل اور مطلق آغاز/اختتام وقت کی گنتی | Launch |
| پلان حوالے سے لائسنس پروڈکٹ/پالیسی میپنگ کا نفاذ اور پالیسی جانچ | Licentivo؛ Launch انتخاب اور رجسٹریشن کا راستہ دیتا ہے |
| لائسنس، فیچر حقوق، ڈیوائس نشستیں، اجازت سیشن، آف لائن اجازت | Licentivo اور سرکاری SDK |
| ڈیوائس فہرست اور دور دراز ان لنک | Licentivo؛ Launch موجودہ اکاؤنٹ کی درخواستیں پراکسی اور نتائج دکھاتا ہے |
| لاگ ان اسناد محفوظ کرنا، اکاؤنٹ بحالی، لاگ آؤٹ راستہ | Launch SDK |

Launch آرڈر، خریداری مدت اور ہم آہنگی مکمل نشان محفوظ فیچرز کو اجازت نہیں دے سکتے۔ کلائنٹ کو سرکاری SDK کے `RunFeature` جیسے رن ٹائم انٹرفیس سے محفوظ کام چلانا ہوگا۔

ہر Launch پروڈکٹ ایک مستحکم عوامی Licentivo پروڈکٹ روٹ محفوظ کرتا ہے۔ ایک پروڈکٹ کے پلان مختلف پالیسیاں منتخب کر سکتے ہیں، لیکن دوسرے دور دراز پروڈکٹ پر نہیں جا سکتے؛ میپنگ محفوظ کرنا مشترک پروڈکٹ کی ڈیٹا بیس قطار لاک سے ترتیب وار جانچا جاتا ہے۔ گاہک شناخت، پلان اشاعت اور SDK انضمامی ترتیب ایک ہی بائنڈنگ پڑھتے ہیں؛ مسودہ پہلے خرید چکے گاہک کا پروڈکٹ سیاق نہیں بدل سکتا۔ یہ صرف انضمامی ترتیب کی مطابقت جانچتا ہے، فیچر یا ڈیوائس اجازت طے نہیں کرتا۔ پرانے ڈیٹا بیس میں مستحکم فیلڈ نہ ہو تو پہلے خریداری اور اشاعت تاریخ دیکھیں؛ منفرد تصدیق ممکن نہ ہو تو `PRODUCT_MAPPING_CONFLICT` واپس آتا ہے۔ تفصیل [میپنگ ہم وقتی اصلاح](/ur/launch-documents/product-mapping-fix-2026-10-24/) میں۔

## خریداری مدت کی ہم آہنگی

موجودہ انٹرفیس دوبارہ استعمال کریں، نئی ادائیگی حقیقت، واپسی حقیقت یا کوٹ سروس شامل نہ کریں:

- `POST /api/v1/launch/connections`、`PUT /connections/{id}`: شناختی دستخطی عوامی کلیدیں رجسٹر کریں، پروڈکشن اور ٹیسٹ ماحول میں الگ کنکشن بنائیں۔
- `PUT /api/v1/launch/connections/{id}/plans/{plan}`: منفرد Launch پلان ورژن حوالہ اور دور دراز پروڈکٹ، پالیسی ورژن رجسٹر کریں۔
- `POST /api/v1/launch/connections/{id}/events`: مکمل ورژن شدہ خریداری سنیپ شاٹ جمع کریں۔
- `GET /api/v1/launch/connections/{id}/events/{event}`: کارروائی نتیجہ تصدیق کریں۔
- `POST /api/v1/launch/connections/{id}/events/{event}/retry`: جانچ کے بعد اصل ایونٹ دوبارہ آزمائیں۔

سنیپ شاٹ میں صرف ایونٹ نمبر، ماحول، ایونٹ قسم، خریداری حوالہ، گمنام اکاؤنٹ حوالہ، Launch پروڈکٹ، پلان ورژن حوالہ، بڑھتا ورژن اور مطلق `valid_from` / `valid_until`؛ منتقلی میں پرانا لائسنس ID شامل۔ ادائیگی کلید، قیمت، گاہک ای میل یا طویل مدتی لائسنس کلید نہیں بھیجی جاتی۔ مستقل خریداری کا `valid_until`، `null` ہے، Licentivo پالیسی سے مطابقت جانچتا ہے۔

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

ہر تبدیلی پر مکمل مطلق اقدار بھیجیں، دوبارہ کوشش وہی ایونٹ ID اور باڈی استعمال کرے، “مزید N دن” نہ بھیجیں۔ کام درخواست، دور دراز کنکشن اور پیش رفت مستقل رکھتا ہے؛ جواب ضائع، عمل دوبارہ شروع اور بیک وقت ورکر سے مدت دو بار جمع نہیں ہوتی۔

HTTP 202 صرف Licentivo کی وصولی ظاہر کرتا ہے۔ صرف `applied` پر ہم آہنگی مکمل نشان زد؛ `pending` پر استفسار جاری، `manual_review` اور غیر مصدقہ `stale` جانچ کے انتظار میں رہتے ہیں۔ نیٹ ورک غلطی پر بیک آف دوبارہ کوشش، مسلسل ناکامی حد پر دستی جانچ۔

واپسی صرف متعلقہ آرڈر کا کوریج وقفہ ہٹاتی ہے: اپ گریڈ آرڈر واپسی بنیادی پلان بحال؛ تجدید آرڈر واپسی متعلقہ توسیع ہٹاتی ہے؛ دوسری غیر واپس شدہ خریداری ہو تو دوبارہ گنا نتیجہ ہم آہنگ، تمام خریداری منسوخ نہیں۔ سب خریداری واپس ہونے پر `entitlement.refunded` بھیجیں۔ بعد میں دوبارہ خریداری نیا حوالہ استعمال کرے تاکہ منسوخ دور دراز لائسنس بحال نہ ہو۔

چینل سے مصدقہ ہاری چارج بیک یا ریورسل بھی صرف متعلقہ آرڈر کی خریداری کوریج ہٹاتا ہے، آرڈر `reversed` دکھتا ہے اور حقیقی اجازت تبدیلی Licentivo خریداری سنیپ شاٹ لاگو کرنے کے بعد کرتا ہے۔ زیر التوا تنازع خریداری ریکارڈ نہیں بدلتا۔ پرانی جانچ منتظر ریورسل اطلاع اصل چینل سے دستخط دوبارہ جانچ کر بھیجنے سے بحال ہو سکتی ہے۔

نامعلوم واپسی دستی جانچ میں جائے تو منتظم `POST /api/v1/admin/refunds/{id}/reconcile` سے اصل کارروائی بحال کر سکتا ہے۔ رسید اصل ٹرانزیکشن، کرنسی اور رقم سے ملے؛ اصل کارروائی نمبر اور منظوری وقت نہ بدلیں، محفوظ دوبارہ کوشش مدت کے بعد رقم درخواست اندھا دھند دوبارہ جمع نہ کریں۔

## اکاؤنٹ اور کلائنٹ

1. کلائنٹ `POST /api/v1/auth/login` سے حقیقی ڈیسک ٹاپ لاگ ان سیشن بناتا ہے۔
2. Launch SDK، `POST /api/v1/software/products/{id}/identity` درخواست کرتا اور `sandbox` یا `live` متعین کرتا ہے۔
3. Launch زیادہ سے زیادہ 120 سیکنڈ کا شناخت assertion جاری کرتا ہے، مقررہ وصول کنندہ اور پروڈکٹ/خریداری سیاق، حقیقی لاگ ان `sid` اور لاگ ان میعاد سمیت۔ assertion میں فیچرز، ڈیوائس الاؤنس یا آف لائن حقوق نہیں۔
4. Launch SDK صرف میموری میں `identity_token`, `launch_connection_id`, `environment` سرکاری SDK کو دیتا ہے، `license_key` خالی ہے۔
5. سرکاری SDK Licentivo `/api/v1/launch/exchange` کال کرتا ہے؛ Licentivo اجازت کا فیصلہ کر کے ڈیوائس اسناد اور دستخط شدہ اجازت جاری کرتا ہے۔

Launch کا معمول کا اکاؤنٹ ریکارڈ v2 استعمال کرتا ہے، صرف اکاؤنٹ سیشن اور عوامی روٹنگ معلومات رکھتا ہے، assertion، لائسنس کلید یا اجازت نہیں۔ واضح لاگ آؤٹ پر صرف تنسیخ کے نجی v3 زیر التوا کام میں بدلتا ہے، جو لاگ ان بحال نہیں کر سکتا؛ Launch سیشن تنسیخ کی تصدیق کے بعد حذف کریں۔ پرانا `/credential` انٹرفیس HTTP 410 واپس کرتا ہے۔ عوامی کلید اور پروڈکٹ ID ایپ کے ساتھ تقسیم ہو سکتے ہیں، انتظامی کلید صرف سرور پر رہتی ہے۔

## لاگ آؤٹ، بندش، دور دراز ان لنک

| عمل | رویّہ |
| --- | --- |
| معمول کا Close / Dispose / Drop | رن ٹائم روکیں، خریداری، ڈیوائس بائنڈنگ اور جان بوجھ کر یاد رکھا اکاؤنٹ برقرار |
| Logout / ReleaseDevice مطابقتی راستہ | مقامی اکاؤنٹ لاگ آؤٹ نشان زد اور سرکاری SDK لاگ آؤٹ کال، پھر Launch سیشن منسوخ؛ غیر مصدقہ لاگ آؤٹ محفوظ زیر التوا کام رکھتا ہے |
| ڈیوائس تک رسائی نہ ہو تو Launch میں ڈیوائس انتظام | Licentivo ڈیوائس فہرست، ان لنک درخواست اور نتیجہ پراکسی کریں |

سرکاری SDK لاگ آؤٹ اس عمل میں اجازت استعمال فوراً روکتا، رن ٹائم اسناد صاف اور مخصوص لاگ آؤٹ ٹکٹ سے دور دراز بائنڈنگ منسوخ کرتا ہے۔ نیٹ ورک ناکامی پر SDK کی `.logout.json` رکھنا لازم؛ نتیجہ دور دراز تنسیخ زیر التوا دکھائے، ان لنک کامیاب نہیں۔ Launch SDK سرکاری SDK کی کیش ڈائریکٹری حذف، اس میں چل کر صفائی یا ترمیم نہیں کرتا؛ متعلقہ کیش دوبارہ شروع ہونے پر سرکاری SDK زیر التوا ٹکٹ بحال کرتا ہے۔

Launch اکاؤنٹ لاگ آؤٹ کی الگ زیر التوا حالت بھی ہے: نیٹ ورک ناکامی، منسوخی یا جواب ضائع ہونے پر دوبارہ کوشش کے محفوظ ریکارڈ حذف نہ کریں؛ دوبارہ لاگ ان، بحالی یا لاگ آؤٹ صرف اصل سیشن تنسیخ دوبارہ جمع کرتے ہیں، زیر التوا کام سے لاگ ان بحال نہیں ہو سکتا۔ کامیابی یا HTTP 401 سے سیشن ناکارہ تصدیق کے بعد حذف کریں۔ عملوں کے پار بحالی کے لیے مستقل محفوظ Store ضروری، MemoryStore صرف اسی عمل میں مؤثر۔ تفصیل [لاگ آؤٹ دوبارہ کوشش اصلاح اور مشترک جانچ](/ur/launch-documents/logout-retry-fix-2026-10-24/) میں۔

دور دراز ان لنک درخواست اصل فہرست کے `activation_id` اور `expected_generation` رکھتی ہے، دوبارہ کوشش وہی `operation_id` استعمال کرتی ہے۔ Launch ان لنک تعداد نہیں گنتا، خود منظوری یا ان لنک قطار نہیں چلاتا اور generation تازہ کر کے پرانی کارروائی خود نہیں دہراتا۔ باقی تعداد، ریلیز اجازت، جائزہ اور حتمی نتیجہ Licentivo سے آتے ہیں۔

اکاؤنٹ بحالی `Restore` میں آن لائن اکاؤنٹ تصدیق اور نیا شناخت assertion ضروری؛ اکاؤنٹ سروس ناکام ہو تو Launch خود آف لائن اجازت نہیں چنتا۔ آف لائن آغاز والی ایپس سرکاری SDK بحالی معاہدے سے جڑیں؛ دستخط، آف لائن مدت اور گھڑی جانچ سرکاری SDK کرتا ہے۔

## سرور جانب شناخت تنسیخ

Licentivo V39 کے موجودہ انٹرفیس سے انضمام، تجارتی حقیقت یا کوٹ انٹرفیس ضروری نہیں:

- `POST /api/v1/launch/connections/{id}/session-revocations`: مخصوص `sid` یا اکاؤنٹ کے پرانے لاگ ان منسوخ، مطابقتی کمٹ رسید واپس۔
- `GET /api/v1/launch/connections/{id}/session-revocations/{event_id}`: اصل ایونٹ کا کمٹ نتیجہ حاصل، گم جواب کی درخواست بحال کریں۔

معمول ڈیسک ٹاپ لاگ آؤٹ اور مخصوص سیشن جبری لاگ آؤٹ میں `scope=session`؛ پاس ورڈ بدلنے/ری سیٹ، ای میل تبدیلی، اکاؤنٹ غیر فعال اور ویب عملہ کردار تبدیلی سے تمام سیشن ناکارہ ہونے پر `scope=account`۔ ویب سیشن کا معمول لاگ آؤٹ گاہک سافٹ ویئر متاثر نہیں کرتا۔ Launch صرف شناخت ناکارہ اطلاع دیتا ہے؛ دور دراز اجازت سیشن، رن ٹائم اسناد اور ڈیوائس ریلیز Licentivo کرتا ہے، خریداری مدت نہیں بدلتی اور Launch کا ان لنک الاؤنس خرچ نہیں ہوتا۔

مقامی سیشن ناکارہ اور اطلاع قطار میں شامل کرنا ایک ٹرانزیکشن میں ہوتا ہے۔ قطار اس وقت موجود کنکشن اور ماحول مقرر کرتی، وہی ایونٹ ID، گمنام اکاؤنٹ شناخت اور اصل درخواست سے دوبارہ کوشش کرتی ہے؛ بعد کے کنکشن پرانی اکاؤنٹ تنسیخ نہیں پاتے۔ پہلے اصل رسید پوچھیں، عدم موجودگی تصدیق کے بعد ہی دوبارہ جمع؛ ہر ماحول کا نتیجہ الگ مستقل، تمام مماثل کامیاب رسیدوں پر ہی مکمل دکھائیں۔ نیٹ ورک منقطع پر خودکار کوشش، اسناد/معاہدہ تصادم پر دستی جانچ۔ منتظم ہم آہنگی کام صفحے پر اطلاع دیکھ اور دوبارہ آزما سکتا ہے؛ نیا تنسیخ ایونٹ نہیں بنتا۔

اکاؤنٹ دائرے کی تنسیخ Licentivo کے پہلی بار وصول کردہ `revoked_before` کی حد پر ہے۔ اطلاع زیر التوا ہو تو نئے ڈیسک ٹاپ لاگ ان اور شناخت assertions معطل؛ تکمیل کے بعد حقیقی لاگ ان کا `auth_time` تمام ماحول کی رسیدوں کے آخری سیکنڈ سے لازماً بعد ہو۔ اسی سیکنڈ کا لاگ ان بعد میں دوبارہ مصدق ہو سکتا ہے؛ `iat` یا شناخت assertion ریفریش پرانا لاگ ان جاری نہیں رکھتا۔ ویب لاگ ان بحالی کے لیے دستیاب ہے۔ اکاؤنٹ دوبارہ فعال ہونے پر بھی نیا لاگ ان ضروری، پرانا سیشن بحال نہیں۔

## پرانے ڈیٹا کی منتقلی

مصدقہ پرانی لائسنس بائنڈنگ والی خریداری `entitlement.migrated` استعمال کرتی ہے، صرف پرانا لائسنس ID جمع، پرانی کلید نہ پڑھتی نہ جاری کرتی ہے۔ Licentivo منتقلی کی تصدیق کے بعد موجودہ تجارتی مدت اور حالت ہم آہنگ کرنے کو الگ نئے ورژن کا سنیپ شاٹ بھیجیں۔ غیر مصدقہ پرانے اجراء نتائج اور غیر مطابقت اجازت دستی جانچ مانگتے ہیں؛ پرانے انتظامی کمانڈ خودکار ری پلے نہیں ہوتے۔

معمول SDK لاگ آؤٹ، دور دراز ڈیوائس ان لنک اور سرور شناخت تنسیخ موجودہ انٹرفیس سے منسلک ہیں۔ دور دراز غیر فعال کرنا سرکاری SDK کے جاری آف لائن اجازت نامے کی مدت سے محدود ہے؛ Launch آف لائن ڈیوائس کو فوری تنسیخ کا وعدہ نہیں کرتا۔

<!-- account-store-ownership-2026-10-24 -->

اکاؤنٹ لاگ آؤٹ الگ محفوظ زیر التوا کام، مقامی سیشن لاگ آؤٹ ڈائجسٹ اور عملوں کے پار ہم آہنگی استعمال کرتا ہے؛ پرانا انسٹینس صرف اپنا لاگ ان سنبھالتا ہے۔ اسٹوریج ناکامی کے بعد بحالی پہلے اکاؤنٹ تنسیخ دوبارہ جمع کرتی ہے، شناخت حاصل یا اجازت شروع نہیں کرتی؛ فیچرز، آف لائن اجازت، ڈیوائس generation اور ان لنک الاؤنس Licentivo طے کرتا ہے۔ تفصیل [اصلاح اور دونوں طرف مشترکہ جانچ ریکارڈ](/ur/launch-documents/account-store-fix-2026-10-24/) میں۔