POS انضمام

سیٹنگز میں انضمام کا صفحہ کسی اہل HandyCafe سرور کو Ödeal D2D ٹرمینل سے جوڑتا ہے۔ دستیابی HandyCafe کلاؤڈ کے ذریعے جانچی جاتی ہے۔ اگر کیفے کو Ödeal استعمال کرنے کی اجازت نہ ہو تو مینو اور صفحہ دونوں مکمل طور پر چھپے رہتے ہیں۔

شروع کرنے سے پہلے

آپ کو ایک فعال HandyCafe کلاؤڈ سبسکرپشن، ایک Ödeal مرچنٹ کلید، اور ایک Ödeal سیکرٹ کلید درکار ہے۔ آپ کو Ödeal کے Cihazlarım حصے میں ٹرمینل بھی بنانا ہوگا۔ اُس ٹرمینل کو دیا گیا بالکل وہی نام اس کی externalDeviceKey ہے۔ کام کا آغاز Stage ماحول سے کریں۔ Production پر صرف اُس وقت جائیں جب Ödeal آپ کے پروڈکشن کریڈنشلز اور کال بیک سیٹ اپ کی منظوری دے دے۔

Ödeal ترتیب دینا

1. سیٹنگز کھولیں اور انضمام منتخب کریں۔
2. Ödeal اکاؤنٹ میں Ödeal کی فراہم کردہ مرچنٹ کلید اور سیکرٹ کلید درج کریں۔ HandyCafe یہ اقدار براہِ راست HandyCafe کلاؤڈ کو بھیجتا ہے۔ وہاں یہ خفیہ کی جاتی ہیں، مقامی ڈیٹابیس میں محفوظ نہیں ہوتیں اور دوبارہ نہیں دکھائی جاتیں۔
3. کنکشن ٹیسٹ منتخب کریں۔ نئی کلیدیں موجود ہونے کی صورت میں HandyCafe انہیں Ödeal API کنکشن جانچنے سے پہلے محفوظ طریقے سے سیو کرتا ہے۔ یہ ٹیسٹ صرف Ödeal اکاؤنٹ کی تصدیق کرتا ہے۔ یہ ثابت نہیں کرتا کہ ٹرمینل کی جوڑ بندی ہو چکی ہے یا وہ آن لائن ہے۔
4. ٹرمینل شامل کریں۔ ایک واضح مقامی ڈیوائس نام درج کریں۔ Ödeal ڈیوائس نام (externalDeviceKey) کے لیے وہی نام درج کریں جو Ödeal میں بنایا گیا تھا۔ اس کے بعد اختیاری PaxID، ماحول، ادائیگی کے انتظار کا وقت، کسٹمر کا شہر، کسٹمر کا ضلع، سیشن VAT کی شرح اور آرڈر VAT کی شرح درج کریں۔
5. POS انضمام فعال آن کریں اور محفوظ کریں منتخب کریں۔
6. ٹرمینل کی جوڑ بندی اور دونوں ادائیگی راستوں کی تصدیق کے لیے Stage پر ایک نقد رسید اور ایک کارڈ ادائیگی مکمل کریں۔

اس ریلیز میں فی سرور صرف ایک فعال Ödeal ٹرمینل کی حمایت موجود ہے۔ اس سے یہ خطرہ ٹلتا ہے کہ کیشیئر کے لیے ٹرمینل منتخب کرنے کا اختیار آنے سے پہلے کوئی ادائیگی غلط ٹرمینل پر چلی جائے۔

HandyCafe ٹرمینل کی فہرست مقامی طور پر محفوظ کر لیتا ہے، اس سے پہلے کہ کلاؤڈ کسی نئے کریڈنشل جوڑے کی تصدیق کرے۔ Ödeal کی جانب سے کریڈنشل مسترد ہونے سے ٹرمینل کا نام یا جوڑ بندی کے خانے ضائع نہیں ہوتے۔ جس ٹرمینل کو نئے کریڈنشلز درکار ہوں وہ اُس وقت تک غیر فعال حالت میں محفوظ رہتا ہے جب تک اس کے منتخب ماحول کے لیے وہ کریڈنشلز تصدیق نہ ہو جائیں۔

انضمام کا صفحہ ٹرمینل کی فہرست براہِ راست مقامی SQLite ڈیٹابیس سے پڑھتا ہے اور کلاؤڈ کا انتظار کیے بغیر دکھاتا ہے۔ صرف خفیہ کردہ کریڈنشل کی صورتحال اور ریموٹ فراہم کنندہ کی اجازت کے لیے کلاؤڈ سے درخواست درکار ہوتی ہے۔

اگر Ödeal ترتیب مسترد کر دے تو HandyCafe اُس کی واپس کی گئی وضاحت دکھاتا ہے۔ تنظیمی پروفائل نہ ملنے کا جواب اس بات کی نشاندہی کرتا ہے کہ مرچنٹ اور سیکرٹ کا جوڑا منتخب کردہ Stage یا Production ماحول میں کسی تنظیم سے تعلق نہیں رکھتا۔

ادائیگی کا طرزِ عمل

جب فعال ادائیگی کا طریقہ نقد یا کارڈ ہو تو PC سیشن کی ادائیگی، کنسول سیشن کی ادائیگی، اور الگ آرڈر کی بندش Ödeal کو ایک آئیڈیمپوٹینٹ باسکٹ بھیجتی ہیں۔ نقد Ödeal کے دستاویزی CASH ادائیگی آپشن کے طور پر بھیجا جاتا ہے۔ ٹرمینل نقد ادائیگی ریکارڈ کرتا ہے اور کارڈ وصولی کی اسکرین کھولے بغیر مالیاتی سلپ یا e-Archive رسید پرنٹ کرتا ہے۔ کارڈ CREDITCARD کے طور پر بھیجا جاتا ہے؛ HandyCafe کال بیک کے نتیجے کا انتظار کرتا ہے جبکہ کسٹمر ٹرمینل پر ادائیگی مکمل کرتا ہے۔ ایسی ادائیگی جس میں نقد اور کارڈ دونوں شامل ہوں، دونوں آپشنز اپنی اپنی رقوم کے ساتھ بھیجتی ہے۔

جب کارڈ اور مرچنٹ معاہدہ اجازت دیں تو کسٹمر ٹرمینل پر قسطوں کا آپشن منتخب کر سکتا ہے۔ HandyCafe رپورٹ کردہ قسطوں کی تعداد مقامی فروخت کے ساتھ محفوظ کرتا ہے۔ مقامی فروخت صرف اُس وقت حتمی کی جاتی ہے جب Ödeal لین دین کی تصدیق کر دے۔ اگر تصدیق کے بعد مقامی اندراج ناکام ہو جائے تو HandyCafe اسی دن منسوخی کی درخواست کرتا ہے۔ ناکام منسوخی ایسی خرابی پیدا کرتی ہے جس کی مطابقت دستی طور پر کرنی پڑتی ہے، اور اسے Ödeal کی لین دین رپورٹ میں جانچنا ضروری ہے۔ نقد اور کارڈ کے علاوہ باقی ادائیگی طریقے HandyCafe کے موجودہ تصفیہ کے بہاؤ سے گزرتے رہتے ہیں۔

ٹیسٹ اور ٹرمینل آپریشنز

کنکشن ٹیسٹ صرف Ödeal مرچنٹ کریڈنشلز اور API رسائی کی تصدیق کرتا ہے۔ یہ کوئی رسید پرنٹ نہیں کرتا، کسی کارڈ سے رقم نہیں لیتا، اور نہ ہی ثابت کرتا ہے کہ externalDeviceKey ٹرمینل کے ساتھ جوڑی گئی ہے۔

فراہم کردہ D2D API دستاویزات میں ٹیسٹ رسید پرنٹ کریں یا ٹیسٹ چارج کے الگ اینڈ پوائنٹس بیان نہیں کیے گئے۔ قبولیتی جانچ Stage ماحول میں عام باسکٹس سے کی جاتی ہے: پہلے نقد باسکٹ بھیجیں اور پرنٹ شدہ سلپ کی تصدیق کریں، پھر کارڈ باسکٹ بھیجیں اور ٹرمینل پر یکمشت یا قسطوں والا لین دین مکمل کریں۔ صرف Ödeal کے فراہم کردہ Stage ٹیسٹ کارڈ کی تفصیلات استعمال کریں۔

Ödeal کے قبولیتی ٹیسٹ کیسز میں دن کی بندش اور آخری رسید کا دوبارہ پرنٹ شامل ہیں، لیکن یہ ٹرمینل کے آپریشنز ہیں۔ D2D ان کے لیے ریموٹ API کالز کی دستاویز نہیں دیتا، اس لیے HandyCafe انہیں ریموٹ بٹنوں کے طور پر پیش نہیں کرتا۔

ریموٹ طور پر فعال اور غیر فعال کرنا

HandyCafe کے منتظمین Ödeal کو ڈیش بورڈ میں Admin > Admin Settings > POS Providers سے کنٹرول کرتے ہیں۔ عالمی سوئچ سب سے اوپر کا کنٹرول ہے۔ ملکی طے شدہ اقدار دو حرفی ISO کوڈز استعمال کرتی ہیں، جیسے TR۔ کیفے کے کنٹرولز کسی ایک لائسنس کے لیے Ödeal کو واضح طور پر کھول یا بند کر سکتے ہیں۔ کیفے کے لیے مخصوص فیصلہ ملکی طے شدہ قدر پر مقدم رہتا ہے۔ کیفے کا فیصلہ ری سیٹ کرنے سے وہ کیفے دوبارہ اپنے ملک کی پیروی کرنے لگتا ہے۔

فیصلے کی ترتیب یہ ہے: عالمی سوئچ، پھر کیفے کے لیے مخصوص فیصلہ، پھر ملکی طے شدہ قدر۔ عالمی سوئچ بند ہو تو ہر کیفے کے لیے Ödeal بند ہو جاتا ہے۔ کیفے کے لیے واضح بندش صفحہ چھپا دیتی ہے، چاہے اس کا ملک کھلا ہو۔ کیفے کے لیے واضح اجازت صفحے کو کھلا رکھتی ہے، چاہے اس کا ملک طے شدہ فہرست میں نہ ہو۔ رسائی بند کرنے سے نئی باسکٹ بننا فوراً رک جاتا ہے۔ پہلے سے زیر التوا لین دین پھر بھی جانچے یا منسوخ کیے جا سکتے ہیں، تاکہ جاری ادائیگی ادھوری نہ رہ جائے۔

سرور دستیابی HandyCafe کلاؤڈ کے ذریعے جانچتا ہے اور آخری کامیابی سے تصدیق شدہ ملکی یا کیفے فیصلہ کیش کر لیتا ہے۔ فراہم کنندہ کیٹلاگ اپنا کریڈنشل غلط ہونے پر ایک منظم error.code کے ساتھ HTTP 200 لوٹاتا ہے۔ ڈیسک ٹاپ اس جواب پر کریڈنشل تازہ کر کے دوبارہ کوشش کرتا ہے۔ عارضی تصدیقی یا نیٹ ورک ناکامی کسی فعال ایڈمن فیصلے کو غیر فعال نہیں سمجھتی، اس لیے انضمام کا مینو مستحکم رہتا ہے۔ بعد میں آنے والا کامیاب جواب کیش کو فوراً اپ ڈیٹ کر دیتا ہے، چاہے وہ ایڈمن کا بند کرنے کا فیصلہ ہی کیوں نہ ہو۔ اگر پہلے سے کوئی تصدیق شدہ فیصلہ موجود نہ ہو تو نامعلوم کیفے ملک، غیر فعال سبسکرپشن یا بند فراہم کنندہ صفحے کو چھپا رکھتے ہیں۔ نئے Ödeal آپریشنز کی اجازت ہمیشہ کلاؤڈ سے دوبارہ لی جاتی ہے، چاہے کیش شدہ نمائش استعمال ہو رہی ہو۔ جب ہم آہنگ شدہ کیفے پروفائل میں ملک درج نہ ہو تو لائسنس پر محفوظ ملک استعمال ہوتا ہے۔

سیکیورٹی اور بحالی

Ödeal کریڈنشلز HandyCafe کلاؤڈ میں تعیناتی والٹ کلید سے خفیہ کیے جاتے ہیں۔ کال بیک درخواستوں کی تصدیق ترتیب دی گئی درخواست کلید سے یا Ödeal مرچنٹ اور سیکرٹ ہیڈرز سے ہوتی ہے۔ باسکٹ کے حوالہ کوڈ ہر آرڈر یا سیشن کے لیے مستحکم رہتے ہیں۔ ایک ہی ادائیگی دہرانے سے دوسرا چارج پیدا نہیں ہوتا۔

Ödeal منسوخی صرف Ödeal کے اسی دن والے قواعد کے تحت، ٹرمینل کا بیچ بند ہونے سے پہلے دستیاب ہے۔ زیر التوا باسکٹ ادائیگی مکمل ہونے سے پہلے الگ سے ہٹائی جا سکتی ہے۔ Ödeal D2D عمومی رقم واپسی کا آپریشن فراہم نہیں کرتا۔ منسوخی کا وقت گزر جانے پر Ödeal کا بیک آفس اور لین دین رپورٹ استعمال کریں۔

Ödeal D2D کوئی دستاویزی ریموٹ Z رپورٹ یا دن بند کرنے کا آپریشن فراہم نہیں کرتا۔ دن کی بندش ٹرمینل پر مکمل کریں۔ HandyCafe مطابقت کے لیے لین دین رپورٹس پڑھ سکتا ہے اور Ödeal سے آنے والے پے بیک کال بیکس ریکارڈ کرتا ہے۔