شماره راهنما48محدودیت‌ها و پیش‌نیازهای پرداخت و تأیید سفارش
حداقل مبلغ، واحد پول، پلن API، callback، پرداخت دیرهنگام، بازگشت وجه و مسئولیت پذیرنده.
تأیید خودکار سفارش تنها وقتی ممکن است که حساب پذیرنده، API، callback و تنظیمات فروشگاه درست باشند. در مسیر جاری فروشگاه، TCart فاکتور را با مبلغ پایه و مبلغ یکتا می‌سازد؛ callback امضاشده باید به همان فاکتور و سفارش برسد. مسیر دستی نیز به بررسی واقعی فروشنده نیاز دارد. هیچ روش پرداختی را بدون آزمون انتهابه‌انتها فعال‌شده فرض نکنید.
پلن و مجوز حساب TCart
هر فروشگاه به حساب پذیرنده و سطح اشتراکی نیاز دارد که API فاکتور را فعال کند. سطح دسترسی، احراز حساب، شرایط کارمزد و تسویه را در پنل رسمی بررسی کنید؛ اطلاعات عمومی سرویس Business به بالا را اعلام می‌کند و شرایط می‌تواند تغییر کند.
حداقل مبلغ و تبدیل ریال به تومان
مبلغ سفارش در سامانه به ریال نگهداری می‌شود و برای TCart به تومان تبدیل می‌شود. مبلغ ریالی باید بر ۱۰ بخش‌پذیر و مبلغ تومانی حداقل ۱۰۰۰ باشد. مبلغ پایه فاکتور باید با total_rial سفارش برابر باشد.
مبلغ یکتا و مهلت پرداخت
TCart برای فاکتور مبلغ یکتای پرداخت برمی‌گرداند؛ خریدار باید همان مبلغ را بپردازد. در درخواست جاری مهلت ۳۰ دقیقه تعیین می‌شود. پرداخت پس از انقضا یا با مبلغ متفاوت ممکن است نیازمند تطبیق دستی باشد و نباید به‌صورت خودکار به سفارش دیگر منتقل شود.
callback و دسترس‌پذیری HTTPS
نشانی عمومی callback باید از اینترنت قابل دسترس و HTTPS باشد. سرور باید هدر X-Resid-Signature را با Secret همان فروشگاه بررسی کند. خطای TLS، پراکسی که payload را تغییر دهد، Secret نادرست یا محدودیت شبکه می‌تواند callback را نامعتبر کند.
استعلام GET تأیید مالی نیست
خواندن وضعیت فاکتور برای تشخیص paid، expired یا cancelled مفید است؛ اما پاسخ GET به‌تنهایی مجوز ثبت وجه در ledger نیست. اگر استعلام paid باشد و callback معتبر نرسیده باشد، پرونده باید برای تطبیق انسانی نگهداری شود.
پرداخت تکراری و درخواست مبهم
اگر ساخت فاکتور timeout شد، ممکن است فاکتور در TCart ایجاد شده باشد. ارسال دوباره درخواست create می‌تواند فاکتور اضافی بسازد؛ سامانه باید همان external_order_id را برای reconciliation نگه دارد. callback تکراری نیز نباید سند مالی دوم ایجاد کند.
تمدید خودکار و ذخیره کارت
اتصال TCart یا پرداخت موفق یک سفارش به معنی ذخیره کارت، برداشت دوره‌ای یا تمدید خودکار اشتراک نیست. در این جریان قابلیت recurring payment به‌عنوان امکان موجود ارائه نمی‌شود.
بازگشت وجه، کارمزد و تسویه
زمان تسویه، کارمزد، اعتراض و بازگشت وجه تابع قرارداد حساب پذیرنده است. قبل از فروش واقعی این موارد را از پنل TCart و فروشنده بررسی کنید؛ صفحه خریدار در این نسخه عملیات refund خودکار را ارائه نمی‌کند.
محدوده روش دستی
وقتی TCart غیرفعال است، رسید بارگذاری‌شده به‌صورت مدرک خصوصی برای فروشنده نگهداری می‌شود؛ تصویر رسید تأیید بانکی نیست. فقط مسئول مجاز می‌تواند مبلغ و مرجع را تطبیق دهد. وقتی TCart فعال است، مسیر بارگذاری رسید برای همان سفارش بسته می‌شود.
مرز درگاه اشتراک و درگاه فروشگاه
درگاه‌های خرید اشتراک اوردیکس در Master DB و مسیر خرید پلتفرم مدیریت می‌شوند؛ کلید TCart فروشگاه در تنظیمات tenant همان فروشگاه قرار دارد. این دو دسته درگاه، حساب پذیرنده و رویداد مالی مشترک ندارند. آداپتورهای دیگر تا زمان اتصال به مسیر checkout فروشگاه نباید به‌عنوان گزینه عملیاتی آن معرفی شوند.
نقشه اجرایی: محدودیت‌ها و پیش‌نیازهای پرداخت و تأیید سفارش
نمای مفهومی از موضوعات این راهنما؛ عنوان‌ها و داده‌ها صرفاً آموزشی‌اند.
پس از مطالعه این راهنما چه مواردی را بررسی کنم؟
- پیش‌نیازها و محدوده دسترسی مرتبط با این بخش را پیش از شروع بررسی کنید.
- هر مرحله را با داده واقعی و در دامنه مجاز فضای کاری انجام دهید.
- پس از اجرا، وضعیت و نتیجه را در همان ماژول بازبینی کنید.
نکته مهم: این شبیه‌سازی داده واقعی را تغییر نمی‌دهد. نتیجه نهایی به مجوز کاربر، پلن، تنظیمات اتصال و سرویس‌های بیرونی وابسته است.