مرکز دانش اوردیکس

راهنما و آموزش استفاده از سامانه

راهنماهای مرحله‌به‌مرحله برای شروع، شناخت محیط، تنظیمات، امنیت و استفاده درست از قابلیت‌ها. هر موضوع با مثال‌های کاربردی و نکات اجرایی توضیح داده شده است.

52 راهنمای مستقلپوشش گام‌به‌گام بخش‌ها و تب‌هاشبیه‌سازی آموزشی و چک‌لیست
فهرست کامل امکانات و صفحهٔ هر قابلیت ←کاربردها بر اساس نوع کسب‌وکار ←
کتابخانه آموزش‌ها

راهنمای دقیق هر بخش را انتخاب کنید

هر صفحه یک موضوع مشخص را پوشش می‌دهد؛ از پیش‌نیاز و ورودی‌ها تا مراحل اجرا، کنترل نتیجه و نکات امنیتی.

52 موضوع آموزشی
پرداخت سفارش، از نگاه خریدار

مسیر روشن از ثبت سفارش تا تأیید دریافت وجه

در نسخه جاری، مسیر خودکار فروشگاه با حساب عادی پذیرنده TCart و مسیر دستی هنگام غیرفعال بودن آن در دسترس است. روش‌های دیگر فقط پس از اتصال کامل و آزمون واقعی checkout قابل معرفی‌اند. آنچه برای خریدار اهمیت دارد نمایش مبلغ روشن، امکان پیگیری و تغییر وضعیت سفارش فقط پس از تأیید معتبر است.

تأیید خودکار درگاه بررسی انسانی درگاه‌های نیازمند اتصال
01
پرداخت برخط و تأیید سروری

فاکتور میزبانی‌شده TCart

در صورت فعال بودن اتصال TCart برای فروشگاه، سفارش به فاکتور حساب عادی همان پذیرنده متصل می‌شود. خریدار به صفحه پرداخت می‌رود و مبلغ یکتای فاکتور را می‌پردازد؛ callback امضاشده پس از تطبیق مبلغ و سفارش امکان ثبت پرداخت را فراهم می‌کند.

تجربه خریدارپرداخت در صفحه میزبانی‌شده TCart یا مسیر متصل‌شده
کنترل سفارشcallback امضاشده و تطبیق فاکتور
وضعیت پیش از تأییددر انتظار پرداخت یا بررسی
02
بررسی و تطبیق دستی

انتقال بانکی با بررسی فروشنده

اگر TCart برای فروشگاه فعال نباشد، خریدار اطلاعات مقصد را می‌بیند و می‌تواند تصویر رسید را از مسیر خصوصی سفارش ارسال کند. فروشنده باید مبلغ و مرجع را بررسی کند؛ رسید به‌تنهایی تأیید نیست.

تجربه خریدارواریز و ارسال رسید
کنترل سفارشتطبیق و تأیید مسئول فروشگاه
وضعیت پیش از تأییددر انتظار پرداخت یا بررسی
03
محدوده توسعه و اتصال

درگاه‌های دیگر و توسعه آینده

ممکن است ارائه‌دهندگان دیگر API فاکتور، مبلغ یکتا یا webhook داشته باشند؛ اما فقط درگاه‌هایی قابل ارائه‌اند که مسیر checkout، تنظیمات پذیرنده، callback و کنترل مالی آن‌ها در نسخه عملیاتی متصل و آزموده شده باشد. وجود adapter در کد به‌تنهایی به معنی گزینه فعال فروشگاه نیست.

تجربه خریدارپرداخت در صفحه میزبانی‌شده TCart یا مسیر متصل‌شده
کنترل سفارشفقط پس از اتصال و آزمون واقعی
وضعیت پیش از تأییددر انتظار پرداخت یا بررسی
جریان پرداخت و تأیید

هر سفارش، یک مسیر پرداخت قابل پیگیری

فاکتور، سفارش و callback با شناسه‌های مستقل به هم متصل می‌شوند. پرداخت نامشخص وارد مسیر تطبیق می‌شود و ثبت مجدد کورکورانه انجام نمی‌گیرد.

۱ثبت سفارش و نگاشت فاکتور

سفارش ابتدا ثبت می‌شود و سپس نگاشت یکتای tenant، فروشگاه، سفارش و فاکتور در سمت سرور نگهداری می‌شود.

۲ساخت فاکتور و پرداخت دقیق

حساب پذیرنده فاکتور می‌سازد؛ خریدار به صفحه پرداخت هدایت می‌شود و مبلغ یکتا را دقیق می‌پردازد.

۳اعتبارسنجی callback

امضای X-Resid-Signature، شناسه فاکتور، شناسه بیرونی و مبلغ پرداختی با رکورد ذخیره‌شده تطبیق داده می‌شوند.

۴ثبت idempotent پرداخت

فقط پس از تطبیق معتبر، ledger و وضعیت سفارش به‌روزرسانی می‌شوند؛ رویداد تکراری اثر مالی دوم ایجاد نمی‌کند.

نکات و محدودیت‌ها

پیش از پرداخت چه مواردی مهم‌اند؟

حساب پذیرنده باید API مجاز داشته باشد؛ مبلغ پایه و یکتای فاکتور باید با سفارش تطبیق کند؛ و کلید و Secret هر فروشگاه باید مستقل بمانند. زمان تسویه، کارمزد، حداقل مبلغ، مهلت فاکتور و بازگشت وجه تابع قرارداد TCart هستند.

بازگشت مرورگر، تأیید پرداخت نیستدر TCart، return_url فقط خریدار را به صفحه پیگیری برمی‌گرداند. ثبت مالی به callback معتبر با X-Resid-Signature و تطبیق invoice_id، external_order_id و مبلغ وابسته است.
مبلغ یکتا باید دقیق پرداخت شودفاکتور TCart مبلغ پایه و unique_amount_toman دارد. خریدار باید مبلغ یکتا را دقیق بپردازد؛ تبدیل ریال به تومان، حداقل مبلغ و انقضای فاکتور باید رعایت شوند.
کلید و Secret برای هر فروشگاه مستقل‌اندکلید API و Secret callback حساب عادی پذیرنده در تنظیمات همان فروشگاه رمزنگاری می‌شوند. کلیدها بین فروشگاه‌ها مشترک نیستند و به مرورگر بازگردانده نمی‌شوند.
وضعیت نامشخص به تطبیق نیاز داردtimeout ساخت فاکتور یا نبود callback، پرداخت قطعی یا شکست قطعی نیست. فاکتور دوم نسازید؛ همان شناسه سفارش و فاکتور را برای reconciliation نگه دارید.
پرداخت تکراری نباید اثر مالی تکراری بسازدcallback تکراری باید با hash رویداد و مرجع یکتای دفتر مالی بی‌اثر شود؛ سفارش، موجودی و ledger نباید دوباره تغییر کنند.
تسویه و بازپرداخت تابع قرارداد استزمان تسویه، کارمزد و روش بازگشت وجه را از پنل و قرارداد TCart یا فروشنده بررسی کنید. صفحه خریدار در این نسخه عملیات refund خودکار ارائه نمی‌کند.
تمدید خودکار را مفروض نگیریدپرداخت یک سفارش به معنی ذخیره کارت یا برداشت دوره‌ای نیست. در جریان جاری فروشگاه، تمدید خودکار یا پرداخت recurring وعده داده نمی‌شود.
قابلیت‌های ارائه‌دهندگان پرداخت

قابلیت‌های وابسته به ارائه‌دهنده، نه اعلام فعال بودن همه آن‌ها در اوردیکس

فهرست زیر نشان می‌دهد یک درگاه یا حساب پذیرنده معمولاً چه چیزی می‌تواند فراهم کند و اوردیکس امروز کدام بخش از آن را مصرف می‌کند. فروشگاه‌ها می‌توانند با اتصال حساب واجد شرایط، همین قابلیت‌ها را به مشتریان خود ارائه دهند؛ اما آنچه در صفحهٔ فروش و در مسیر پرداخت وعده داده می‌شود، باید مسیر ساخته‌شده و آزموده‌شده باشد.

راهنمای کامل قابلیت‌های پرداخت و درگاه‌ها ←
تأیید سروری پرداخت (verify)در جریان جاری مصرف می‌شودپس از بازگشت خریدار، نتیجه با کلید همان حساب دوباره از سرویس پرسیده می‌شود؛ همان پاسخ verify یا callback است که پرداخت را ثبت می‌کند، نه پیام صفحهٔ بانک.
رویداد یا وب‌هوک امضاشدهدر اتصال فروشگاه مصرف می‌شودرویداد روی بدنهٔ خام با رمز اختصاصی همان حساب بررسی و در پنجرهٔ زمانی پذیرفته می‌شود و اثر مالی آن به‌صورت idempotent ثبت می‌گردد.
مبلغ یکتای صورتحساببرای تطبیق ماشینی مصرف می‌شوددر سرویس‌های کارت‌به‌کارت با تشخیص خودکار، رقم یکتا واریز را به همان سفارش وصل می‌کند؛ پرداخت مبلغ متفاوت پرونده را به بررسی دستی می‌فرستد.
محیط آزمایشی و کلید تستیدر تنظیمات پشتیبانی می‌شودمیزبان و کلید آزمایشی قابل تنظیم است و آزمون اتصال گرفته می‌شود؛ نتیجهٔ ساندباک جایگزین تراکنش واقعی و تأیید مالی نیست.
بازگشت وجهدر پنل ارائه‌دهنده، نه در صفحهٔ خریداربازگشت وجه از پنل یا API همان درگاه انجام می‌شود. در این نسخه، صفحهٔ خریدار دکمهٔ بازگشت خودکار ندارد و لغو سفارش به‌تنهایی وجه را برنمی‌گرداند.
پرداخت دوره‌ای و تمدید خودکارارائه نمی‌شودچنین مسیری هم پشتیبانی صریح ارائه‌دهنده می‌خواهد و هم طراحی مستقل در سامانه؛ امروز هر پرداخت با درخواست روشن کاربر انجام می‌شود.
تقسیط مبلغ و مسیریابی چنددرگاهیارائه نمی‌شودپرداخت قسطی یا انتخاب خودکار میان چند درگاه در نسخهٔ جاری پیاده‌سازی نشده است و نباید در متن فروش یا صفحهٔ پرداخت وعده داده شود.
راهنماهای تخصصی پرداخت و درگاه

جزئیات فنی جریان جاری TCart، تجربه خریدار، روش دستی جایگزین، مرز پرداخت اشتراک و پیش‌نیازهای حساب پذیرنده در صفحات مستقل توضیح داده شده‌اند.

مرور قابلیت‌های پرداخت و سفارش ← معماری درگاه و تأیید تراکنش ← تأیید خودکار پرداخت سفارش ← راه‌اندازی درگاه از صفر ← عیب‌یابی پرداخت ← اتصال TCart فروشنده ← راهنمای خریدار ← محدودیت‌ها و پیش‌نیازها ← فهرست کامل امکانات اوردیکس ←