شماره راهنما49تأیید خودکار پرداخت سفارش فروشگاه
چگونه واریز خریدار به همان سفارش متصل می‌شود: فاکتور، مبلغ یکتا، callback امضاشده، دفتر رویدادها و ستون تأیید واریز.
در یک فروشگاه، «رسید» و «پرداخت تأییدشده» دو چیز متفاوت‌اند. اوردیکس وضعیت سفارش را تنها از کانال سرور‌به‌سرور و پس از تطبیق مبلغ و شناسه تغییر می‌دهد. این صفحه همان مسیر را مرحله‌به‌مرحله توضیح می‌دهد تا بدانید چه چیزی تأیید محسوب می‌شود و چه چیزی نمی‌شود.
فاکتور با کلید API همان فروشگاه ساخته می‌شود
طبق مستندات تیکارت، هر کلید API دقیقاً به یک حساب فروشنده وصل است. پس از فعال‌سازی درگاه در صفحهٔ «درگاه پرداخت فروشگاه»، فاکتور سفارش با کلید همان فروشگاه و روی حساب خودش ساخته می‌شود؛ وجه به کارت ثبت‌شدهٔ همان حساب می‌نشیند و هیچ حساب میانی‌ای در میان نیست. اگر فروشگاه کلید نداشته باشد یا آن را غیرفعال کند، همان فروشگاه به روش کارت‌به‌کارت دستی قبلی برمی‌گردد و سفارش بی‌پرداخت نمی‌ماند.
شناسه بیرونی، پل یک‌به‌یک سفارش و فاکتور
برای هر سفارش یک شناسه بیرونی یکتا ساخته می‌شود که از ترکیده شماره فروشگاه و شماره سفارش به دست می‌آید و فقط یک بار برای همان سفارش استفاده می‌شود. وقتی نتیجهٔ ساخت فاکتور نامشخص بماند (مثلاً قطعی شبکه)، سامانه فاکتور دوم نمی‌سازد؛ رکورد در وضعیت «نیازمند تطبیق» می‌ماند و با دکمهٔ پیگیری از خود درگاه پرسیده می‌شود. این قاعده از دو فاکتور برای یک سفارش و دوبار‌ثبت‌شدن درآمد جلوگیری می‌کند.
مبلغ یکتا و نقش آن در تطبیق
در روش‌های کارت‌به‌کارت، خریدار باید مبلغ یکتای همان فاکتور را واریز کند، نه مبلغ گرد سفارش. رقم‌های آخر مبلغ یکتا همان چیزی است که واریز را به این سفارش نسبت می‌دهد. اگر خریدار مبلغ پایه یا مبلغ دست‌کاری‌شده واریز کند، تطبیق انجام نمی‌شود و سفارش در انتظار می‌ماند؛ راه درست، پیگیری از همان صفحه و هماهنگی با فروشنده است، نه پرداخت دوباره.
چه چیزی پرداخت را تأیید می‌کند
تأیید فقط از پیام امضاشدهٔ «payment.confirmed» می‌آید: پیش از هر اثر مالی، امضای HMAC روی بدنهٔ مرتب‌شده با Secret همان حساب بررسی، رویداد در دفتر رویدادها ثبت و مبلغ پرداختی با مبلغ یکتای فاکتور تطبیق داده می‌شود. بستن یا بازکردن دوبارهٔ صفحهٔ بانک، نشان دادن لینک بازگشت به کسی دیگر، تصویر رسید و حتی پاسخ GET استعلام وضعیت - هیچ‌کدام به‌تنهایی تأیید نیستند و حسابرسی نمی‌سازند.
ستون «تأیید واریز» در فهرست سفارش‌ها
در بخش سفارش‌ها، ستون تأیید واریز نشان می‌دهدوصول چگونه قطعی شده است: تأیید خودکار از درگاه، یا بررسی دستی مسئول مالی پس از تطبیق با گزارش بانک. این تفکیک به حسابدار اجازه می‌دهد بداند کدام ردیف پشتوانهٔ سرور‌به‌سرور دارد و کدام ردیف نیاز به مدارک بیشتر دارد؛ سند مالی هم دقیقاً از همان نقطهٔ تأیید ساخته می‌شود.
ثبت یک‌بار مالی و رفتار با رویداد تکراری
برای هر پرداخت تأییدشده، یک سند با مرجع یکتا ثبت می‌شود. اگر همان callback دوباره برسد، سامانه اثر مالی دوم ایجاد نمی‌کند و وضعیت همان سفارش را برمی‌گرداند. اگر سفارش پیش از رسیدن خبر تأیید، لغو یا منقضی شده باشد، رویداد در مسیر «بررسی دستی» می‌ماند تا تکلیف وجه روشن شود؛ در این حالت وجه به‌صورت خودکار بازگردانده نمی‌شود و مسیر آن از طریق درگاه یا انتقال دستی و با شمارهٔ پیگیری است.
فاصلهٔ زمانی و مهلت فاکتور
هر فاکتور مهلت مشخصی دارد و پس از آن منقضی می‌شود. تأخیر در تأیید معمولاً به معنی از دست رفتن وجه نیست و بیشتر از دو حالت می‌آید: پیامک بانک هنوز خوانده نشده است، یا رویداد تأیید به سرویس نرسیده است. در این مدت سفارش روی همان شناسه نگه داشته می‌شود و لازم نیست خریدار دوباره پرداخت کند.
چه زمانی باید دستی بررسی کرد
اگر مبلغ واریزی با مبلغ یکتا نمی‌خواند، اگر خریدار به کارت دیگری واریز کرده است، اگر وضعیت «نیازمند تطبیق» مانده است، یا اگر سفارش پس از پرداخت بسته شده - مسیر، بررسی دستی مسئول مالی با گزارش بانک و شمارهٔ پیگیری است. در این بررسی، تصویر رسید فقط مدرک کمکی است و مبنای ثبت، تطبیق با گزارش بانک یا پاسخ خود درگاه است.
نقشه اجرایی: تأیید خودکار پرداخت سفارش فروشگاه
نمای مفهومی از موضوعات این راهنما؛ عنوان‌ها و داده‌ها صرفاً آموزشی‌اند.
پس از مطالعه این راهنما چه مواردی را بررسی کنم؟
- پیش‌نیازها و محدوده دسترسی مرتبط با این بخش را پیش از شروع بررسی کنید.
- هر مرحله را با داده واقعی و در دامنه مجاز فضای کاری انجام دهید.
- پس از اجرا، وضعیت و نتیجه را در همان ماژول بازبینی کنید.
نکته مهم: این شبیه‌سازی داده واقعی را تغییر نمی‌دهد. نتیجه نهایی به مجوز کاربر، پلن، تنظیمات اتصال و سرویس‌های بیرونی وابسته است.