انوائس کا لائف سائیکل

انوائس بننے سے لے کر بند ہونے یا میعاد ختم ہونے تک ایک سفر طے کرتی ہے۔ یہ سیکشن بتاتا ہے کہ وہ کن حالتوں میں ہو سکتی ہے، ان کے درمیان کیسے منتقل ہوتی ہے، اور ہر مرحلے پر تاجر کیا کر سکتا ہے۔

انوائس کے اسٹیٹس

اسٹیٹس	API قدر	تفصیل	ادائیگی کی تلاش میں شامل
غیر ادا شدہ (Unpaid)	unpaid	انوائس جاری ہو چکی ہے، ادائیگی کی مہلت ختم نہیں ہوئی، کوئی ادائیگی موصول نہیں ہوئی	ہاں
ادا شدہ (Paid)	paid	ادائیگی مل گئی اور انوائس سے منسلک ہو گئی	نہیں
میعاد ختم (Expired)	expired	ادائیگی کی مہلت گزر گئی، کوئی ادائیگی موصول نہیں ہوئی	ہاں، میعاد ختم ہونے کے بعد مزید ایک گھنٹے تک
منسوخ (Canceled)	canceled	تاجر نے انوائس دستی طور پر یا API کے ذریعے منسوخ کی	نہیں

اسٹیٹس کی تبدیلیاں

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

ادا شدہ اسٹیٹس والی انوائس کی حالت بھی نہیں بدلتی — اسے نہ دوبارہ ادا کیا جا سکتا ہے اور نہ منسوخ۔

ادائیگی کی مہلت

مہلت انوائس بناتے وقت طے ہوتی ہے اور 30 منٹ سے 12 گھنٹے تک ہوتی ہے۔ اجازت شدہ قدریں: 30 منٹ، ایک گھنٹہ، 3 گھنٹے، 6 گھنٹے، 12 گھنٹے۔

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

دونوں انتہاؤں کی اپنی قیمت ہے۔ کم مہلت سست نیٹ ورکس پر خطرناک ہے — ممکن ہے گاہک وقت پر ادائیگی نہ کر پائے۔ طویل مہلت انوائس بنتے وقت کی شرح تبادلہ اور ادائیگی کے وقت کی شرح تبادلہ کے درمیان فرق بڑھا دیتی ہے۔

ادائیگی کی تلاش کی مدت

ادائیگی کی تلاش مہلت ختم ہونے کے بعد مزید ایک گھنٹے تک جاری رہتی ہے — سست نیٹ ورکس کی وجہ سے، جہاں ٹرانزیکشن کی تصدیق انوائس کی میعاد رسمی طور پر ختم ہونے کے بعد ہو سکتی ہے۔ اس پورے وقت گاہک کو انوائس میعاد ختم نظر آتی ہے، لیکن جب درست رقم کی ادائیگی آتی ہے، تو انوائس تمام اطلاعات کے ساتھ خودکار طور پر ادا شدہ ہو جاتی ہے۔

اسی لیے انٹیگریٹرز کے لیے اصول: ادائیگی کی اطلاع کو اس بنا پر رد نہ کریں کہ مہلت گزر چکی ہے — ایسی جانچ حقیقی ادائیگیوں کا ایک حصہ کاٹ دیتی ہے۔

انوائس کی منسوخی

اگر انوائس میں کوئی غلطی ہو تو آپ اسے منسوخ کر سکتے ہیں۔ منسوخی کے لیے دو شرطیں ہیں:

• انوائس ادا نہیں ہوئی — یعنی وہ غیر ادا شدہ اسٹیٹس میں ہے
• کسی نے انوائس کا ادائیگی کا صفحہ نہیں کھولا؛ ویوز کا کاؤنٹر صفر ہے

دوسری شرط ایسی انوائس کی منسوخی سے بچاتی ہے جسے گاہک پہلے ہی دیکھ چکا ہو اور شاید ادائیگی شروع کر چکا ہو۔

منسوخی ناقابل واپسی ہے۔ منسوخ انوائس ادائیگی کی تلاش سے خارج ہو جاتی ہے، اور آپ اس سے کوئی ادائیگی دستی طور پر بھی منسلک نہیں کر سکتے۔ اگر ادائیگی کا امکان ہو تو منسوخ کرنے کے بجائے مہلت گزرنے کا انتظار کریں — میعاد ختم انوائس ادائیگی آنے پر اب بھی بند ہو سکتی ہے۔

بنتے وقت کیا مقرر ہوتا ہے اور ادائیگی پر کیا دوبارہ شمار ہوتا ہے

انوائس بنتے وقت سروس فیاٹ رقم کو موجودہ شرح تبادلہ پر کرپٹو میں تبدیل کرتی ہے اور حاصل شدہ رقمیں انوائس کے لیے مقرر کر دیتی ہے۔ یہی رقمیں گاہک کو نظر آتی ہیں، اور انہی کو سروس آن چین تلاش کرتی ہے۔ شرح تبادلہ اب ان پر اثر نہیں ڈالتی: چاہے جتنا بھی وقت گزر جائے، گاہک بالکل مقرر شدہ رقم ادا کرتا ہے۔

ادائیگی کے لمحے حساب کتاب کی رقمیں دوبارہ شمار ہوتی ہیں:

فیلڈ	کیا ہوتا ہے
amountFiat	فیاٹ کرنسی میں انوائس کی اصل رقم۔ کبھی نہیں بدلتی
amountFiatUSD	سروس اسے اصل میں موصول ہونے والی رقم سے بدل دیتی ہے، جو ادائیگی کے لمحے کی شرح تبادلہ پر USD میں تبدیل ہوتی ہے
commissionFiatUSD	نئی amountFiatUSD قدر سے پروجیکٹ کی فیس کی شرح پر دوبارہ شمار ہوتی ہے

شرح تبادلہ میں اتار چڑھاؤ کی وجہ سے یہ قدریں اصل قدروں سے مختلف ہو سکتی ہیں، چاہے ادائیگی بالکل درست ہو۔ اپنے اسٹور میں آرڈر سے ملان کے لیے amountFiat استعمال کریں — یہی واحد رقم ہے جو تبدیل نہیں ہوتی۔

انوائس کی زندگی میں اطلاعات

اطلاعات ہر پروجیکٹ کے لیے الگ سیٹ ہوتی ہیں۔ انوائس کی دو اطلاعات ہوتی ہیں:

• آنے والی ادائیگی (Incoming payment)۔ جب بھی آپ کے والٹ پر کوئی آنے والی ٹرانزیکشن ملتی ہے، یہ اطلاع ای میل اور Telegram پر جاتی ہے، چاہے وہ کسی انوائس سے منسلک ہوئی ہو یا نہیں۔
• انوائس ادا ہو گئی (Invoice paid)۔ جس لمحے انوائس ادا شدہ اسٹیٹس میں جاتی ہے، یہ اطلاع ای میل، Telegram اور Webhook URL پر جاتی ہے — خودکار اور دستی دونوں طرح منسلک کرنے پر۔

اس سے تشخیص کا ایک آسان اصول نکلتا ہے: اگر آنے والی ادائیگی کی اطلاع آئی لیکن اس کے بعد ادا شدہ انوائس کی اطلاع نہیں آئی، تو رقم کے فرق کی وجہ سے ادائیگی منسلک نہیں ہوئی اور اسے دستی کارروائی درکار ہے۔

گاہک کو اسٹور کی سائٹ پر واپس بھیجنا

پروجیکٹ کی سیٹنگز میں آپ دو URL سیٹ کر سکتے ہیں جن پر گاہک ادائیگی کے صفحے سے واپس جاتا ہے:

• کامیابی کا URL (Successful URL) — انوائس ادا ہونے کے بعد خودکار ری ڈائریکٹ
• ناکامی کا URL (Unsuccessful URL) — میعاد ختم یا منسوخ انوائس کھولنے پر خودکار ری ڈائریکٹ

ہر URL الگ سے آن ہوتا ہے۔ اگر URL سیٹ نہیں ہے، تو گاہک ادائیگی کے صفحے پر ہی رہتا ہے اور انوائس کا اسٹیٹس دیکھتا ہے۔

سروس URL کے آخر میں uid پیرامیٹر — گاہک کے لیے انوائس کی شناخت — شامل کرتی ہے: https://example.com/order/success?uid=AFhygKX21ecd۔ اسٹور اسی سے آرڈر تلاش کرتا ہے اور گاہک کو اس کا اپنا صفحہ دکھاتا ہے۔

ان URLs پر پہنچنا ادائیگی کی تصدیق نہیں ہے — گاہک لنک خود بھی کھول سکتا ہے۔ آرڈرز Webhook کی بنیاد پر مکمل کریں، یا API کے ذریعے انوائس کا اسٹیٹس جانچنے کے بعد۔