یکپارچهسازیهای POS
صفحه تنظیمات یکپارچهسازیها یک سرور واجد شرایط HandyCafe را به پایانه Ödeal D2D وصل میکند. واجد شرایط بودن از طریق ابر HandyCafe بررسی میشود. وقتی کافه اجازه استفاده از Ödeal را نداشته باشد، منو و صفحه بهطور کامل پنهان میمانند.
پیش از شروع
به یک اشتراک فعال ابر HandyCafe، یک کلید بازرگان و یک کلید مخفی Ödeal نیاز دارید. همچنین باید پایانه را در بخش Cihazlarım در Ödeal بسازید. نام دقیقی که به آن پایانه میدهید همان externalDeviceKey است. کار را با محیط Stage آغاز کنید. تنها پس از آنکه Ödeal اعتبارنامههای محیط Production و پیکربندی فراخوان بازگشتی (callback) را تأیید کرد به Production منتقل شوید.
پیکربندی Ödeal
- تنظیمات را باز کنید و یکپارچهسازیها را انتخاب کنید.
- در بخش حساب Ödeal، کلید بازرگان و کلید مخفی ارائهشده از سوی Ödeal را وارد کنید. HandyCafe این مقادیر را مستقیماً به ابر HandyCafe میفرستد. آنها رمزگذاری میشوند و در پایگاهداده محلی ذخیره یا دوباره نمایش داده نمیشوند.
- آزمون اتصال را انتخاب کنید. وقتی کلیدهای جدیدی وارد شده باشد، HandyCafe پیش از آزمودن اتصال به API Ödeal آنها را بهصورت امن ذخیره میکند. این آزمون تنها حساب Ödeal را تأیید میکند. جفت شدن یا آنلاین بودن پایانه را ثابت نمیکند.
- پایانه را اضافه کنید. یک نام محلی روشن برای دستگاه وارد کنید. برای نام دستگاه در Ödeal (externalDeviceKey) دقیقاً همان نام دستگاهی را که در Ödeal ساختهاید وارد کنید. سپس مقادیر اختیاری PaxID، محیط، زمان انتظار پرداخت، شهر مشتری، منطقه مشتری، نرخ مالیات بر ارزش افزوده نشست و نرخ مالیات بر ارزش افزوده سفارش را وارد کنید.
- یکپارچهسازی POS فعال را روشن کنید و ذخیره را انتخاب کنید.
- یک رسید نقدی Stage و یک پرداخت کارتی Stage را کامل کنید تا جفت شدن پایانه و هر دو مسیر تسویه را تأیید کنید.
در این نسخه تنها یک پایانه فعال Ödeal برای هر سرور پشتیبانی میشود. تا پیش از آنکه انتخابگر پایانه برای صندوقدار در دسترس قرار بگیرد، این محدودیت مانع میشود پرداختی به پایانهای ناخواسته هدایت شود.
HandyCafe فهرست پایانهها را پیش از آنکه ابر جفت اعتبارنامه جدید را تأیید کند بهصورت محلی ذخیره میکند. رد شدن اعتبارنامه Ödeal، نام پایانه یا فیلدهای جفت شدن را دور نمیریزد. پایانهای که به اعتبارنامه جدید نیاز دارد تا زمان تأیید آن اعتبارنامهها برای محیط انتخابشدهاش غیرفعال ذخیره میشود.
صفحه یکپارچهسازیها فهرست پایانهها را مستقیماً از پایگاهداده محلی SQLite میخواند و بدون انتظار برای ابر نمایش میدهد. تنها وضعیت اعتبارنامه رمزگذاریشده و مجوز ارائهدهنده از راه دور به یک درخواست ابری نیاز دارند.
اگر Ödeal پیکربندی را رد کند، HandyCafe توضیحی را که Ödeal برگردانده نمایش میدهد. پاسخ «پروفایل سازمان یافت نشد» یعنی جفت کلید بازرگان و مخفی به هیچ سازمانی در محیط Stage یا Production انتخابشده تعلق ندارد.
رفتار پرداخت
وقتی روش پرداخت فعال نقد یا کارت باشد، تسویه نشست رایانه، تسویه نشست کنسول و بستن سفارش مستقل، یک سبد با شناسه یکتا (idempotent) به Ödeal میفرستند. نقد بهعنوان گزینه پرداخت مستند CASH در Ödeal ارسال میشود. پایانه پرداخت نقدی را ثبت میکند و فیش مالی یا رسید e-Archive را بدون باز کردن صفحه دریافت کارتی چاپ میکند. کارت بهعنوان CREDITCARD ارسال میشود و HandyCafe در حالی که مشتری پرداخت را روی پایانه کامل میکند منتظر نتیجه فراخوان بازگشتی میماند. تسویهای که هم نقد و هم کارت دارد، هر دو گزینه پرداخت را با مبالغ مربوط به خودشان میفرستد.
اگر کارت و قرارداد بازرگان از اقساط پشتیبانی کنند، مشتری میتواند روی پایانه گزینه اقساط را انتخاب کند. HandyCafe تعداد اقساط گزارششده را همراه با فروش محلی ذخیره میکند. فروش محلی تنها پس از تأیید تراکنش از سوی Ödeal نهایی میشود. اگر نهاییسازی محلی پس از تأیید شکست بخورد، HandyCafe درخواست لغو در همان روز را میفرستد. لغو ناموفق یک خطای تطبیق دستی تولید میکند و باید در گزارش تراکنش Ödeal بررسی شود. روشهای پرداخت غیر از نقد و کارت، مسیر تسویه موجود HandyCafe را ادامه میدهند.
آزمونها و عملیات پایانه
آزمون اتصال تنها اعتبارنامههای بازرگان Ödeal و دسترسی به API را تأیید میکند. این آزمون رسیدی چاپ نمیکند، از کارتی مبلغی نمیگیرد و ثابت نمیکند که externalDeviceKey با پایانه جفت شده است.
مستندات ارائهشده API D2D نقطه پایانی جداگانهای برای چاپ رسید آزمایشی یا شارژ آزمایشی تعریف نمیکند. آزمون پذیرش با سبدهای عادی در محیط Stage انجام میشود: یک سبد نقدی بفرستید و فیش چاپشده را بررسی کنید، سپس یک سبد کارتی بفرستید و تراکنشی تکپرداختی یا اقساطی را روی پایانه کامل کنید. تنها از اطلاعات کارت آزمایشی Stage که Ödeal ارائه میدهد استفاده کنید.
موارد پذیرش Ödeal شامل بستن روز و چاپ مجدد آخرین رسید هستند اما اینها عملیات خودِ پایانهاند. D2D فراخوانی API از راه دور برای آنها مستند نکرده است، بنابراین HandyCafe آنها را بهصورت دکمه از راه دور ارائه نمیدهد.
فعال و غیرفعال کردن از راه دور
مدیران HandyCafe، Ödeal را از مسیر Admin > Admin Settings > POS Providers در داشبورد کنترل میکنند. کلید سراسری، کنترل اصلی است. پیشفرضهای کشوری از کد دوحرفی ISO مانند TR استفاده میکنند. کنترلهای کافه میتوانند Ödeal را برای یک مجوز بهصراحت باز یا مسدود کنند. تصمیم مخصوص یک کافه بر پیشفرض کشور غلبه میکند. بازنشانی تصمیم کافه باعث میشود آن کافه دوباره از کشور خود پیروی کند.
ترتیب تصمیمگیری چنین است: کلید سراسری، تصمیم مخصوص کافه، سپس پیشفرض کشور. کلید سراسری خاموش، Ödeal را برای همه کافهها میبندد. بستن صریح یک کافه صفحه را پنهان میکند حتی اگر کشورش باز باشد. باز کردن صریح یک کافه صفحه را مجاز میکند حتی اگر کشورش در فهرست پیشفرض نباشد. خاموش کردن دسترسی، ساخت سبد جدید را بیدرنگ مسدود میکند. تراکنشهای در انتظارِ موجود همچنان قابل بررسی یا لغو هستند تا پرداختی که در جریان است بلاتکلیف نماند.
سرور واجد شرایط بودن را از طریق ابر HandyCafe بررسی میکند و آخرین تصمیم کشور یا کافه را که با موفقیت تأیید شده در حافظه نهان نگه میدارد. وقتی اعتبارنامه فهرست ارائهدهندگان نامعتبر باشد، آن فهرست پاسخ HTTP 200 با error.code ساختاریافته برمیگرداند. نسخه دسکتاپ این پاسخ را با تازهسازی اعتبارنامه و تلاش دوباره مدیریت میکند. خطای موقت احراز هویت یا شبکه، تصمیم فعال مدیر را غیرفعال تفسیر نمیکند، بنابراین منوی یکپارچهسازیها پایدار میماند. پاسخ موفق بعدی حافظه نهان را بیدرنگ بهروز میکند، از جمله تصمیم غیرفعالسازی مدیر. اگر هیچ تصمیم تأییدشده پیشینی وجود نداشته باشد، کشور نامشخص کافه، اشتراک غیرفعال یا ارائهدهنده غیرفعال صفحه را پنهان نگه میدارد. عملیات جدید Ödeal همیشه دوباره از سوی ابر مجاز شمرده میشود، حتی وقتی از نمایش ذخیرهشده در حافظه نهان استفاده شود. وقتی پروفایل همگامشده کافه کشوری نداشته باشد، از کشور ذخیرهشده روی مجوز استفاده میشود.
امنیت و بازیابی
اعتبارنامههای Ödeal در ابر HandyCafe با کلید خزانه استقرار رمزگذاری میشوند. درخواستهای فراخوان بازگشتی با کلید درخواست پیکربندیشده یا با سرآیندهای بازرگان و مخفی Ödeal احراز هویت میشوند. کدهای مرجع سبد برای هر سفارش یا نشست پایدار هستند. تکرار همان تسویه، شارژ دومی ایجاد نمیکند.
لغو در Ödeal تنها بر پایه قواعد همانروزِ Ödeal و پیش از بسته شدن دسته پایانه در دسترس است. سبد در انتظار را میتوان جداگانه و پیش از تکمیل پرداخت حذف کرد. Ödeal D2D عملیات بازپرداخت عمومی ارائه نمیدهد. وقتی بازه لغو گذشته باشد از پنل مدیریت Ödeal و گزارش تراکنش استفاده کنید.
Ödeal D2D عملیات مستندی برای گزارش Z یا بستن روز از راه دور ارائه نمیدهد. بستن روز را روی پایانه انجام دهید. HandyCafe میتواند گزارشهای تراکنش را برای تطبیق بخواند و فراخوانهای بازگشتی payback را از Ödeal ثبت میکند.