WOO MELLAT PAYMENT GATEWAY
درگاه پرداخت ملت ووکامرس؛ دانلود رایگان
اگر برای فروشگاه وردپرسی خود پذیرندگی به‌پرداخت ملت دارید، این افزونه اتصال درگاه ملت به ووکامرس را فراهم می‌کند. مشتری سفارش را ثبت می‌کند، به صفحه پرداخت بانک می‌رود و پس از بررسی نتیجه، به فروشگاه برمی‌گردد. برای همین مسیر معمول خرید، نیازی به فعال‌کردن تسهیم یا بازپرداخت ویژه ندارید.
افزونه رایگان درگاه پرداخت ملت برای وردپرس
اگر دنبال افزونه درگاه پرداخت ملت رایگان هستید تا مشتریان فروشگاهتان آنلاین پرداخت کنند، این محصول همان مسیر اصلی را در ووکامرس فراهم می‌کند: انتخاب درگاه، ورود به صفحه پرداخت و برگشت نتیجه به سفارش. فایل نصب نسخه جدید از همین صفحه قابل دریافت است و برای فعال‌سازی افزونه، خرید لایسنس لازم نیست.
اگر برای فروشگاه وردپرسی خود پذیرندگی به‌پرداخت ملت دارید، این افزونه اتصال درگاه ملت به ووکامرس را فراهم می‌کند. مشتری سفارش را ثبت می‌کند، به صفحه پرداخت بانک می‌رود و پس از بررسی نتیجه، به فروشگاه برمی‌گردد. برای همین مسیر معمول خرید، نیازی به فعال‌کردن تسهیم یا بازپرداخت ویژه ندارید.
برای فروش کالا، فایل و خدمات
چه فروشگاه پوشاک داشته باشید، چه موبایل و لوازم کودک بفروشید یا فایل آموزشی ارائه کنید، پرداخت به سفارش ووکامرس وصل می‌شود. پس از تأیید معتبر، ادامه سفارش و دسترسی دانلود طبق تنظیمات فروشگاه انجام می‌شود.
پرداخت با کارت‌های عضو شتاب
مشتری لازم نیست مشتری همان بانک باشد؛ پرداخت با کارت‌های پشتیبانی‌شده شبکه شتاب در صفحه درگاه انجام می‌شود. شماره کامل کارت، رمز و CVV2 را در فرم فروشگاه شما وارد نمی‌کند.
نصب رایگان، تنظیمات روشن
ZIP را نصب کنید، اطلاعات پذیرندگی را وارد کنید و با یک سفارش کوچک مسیر پرداخت را بررسی کنید. سرویس‌های حرفه‌ای اختیاری‌اند؛ برای خرید معمولی لازم نیست همه گزینه‌های پنل را تغییر دهید.
ابتدا نسخه مناسب سرویس بانک، اطلاعات درست پذیرندگی و دامنه و IP تأییدشده را بررسی کنید. این افزونه، تأیید بانکی و ثبت نتیجه را برای رسیدگی به خطاهای رایج فراهم می‌کند؛ اختلال بانک یا هاست را هیچ افزونه‌ای به‌تنهایی حذف نمی‌کند. راهنمای نصب و بخش پرسش‌های متداول همین صفحه، مسیر بررسی مشکلات معمول را توضیح می‌دهند.
وقتی مشتری می‌گوید «پول کم شد»، چه چیزی را بررسی می‌کنید؟
مشتری سفارش ثبت کرده، از بانک برگشته و پیام نتیجه را ندیده است. مدیر فروشگاه از یک طرف نباید سفارش پرداخت‌نشده را تحویل بدهد و از طرف دیگر نباید مشتری را به پرداخت دوباره یک تراکنش نامشخص هدایت کند. این افزونه برای ثبت درخواست، بررسی نتیجه بانک و ارتباط دادن آن به سفارش ووکامرس طراحی شده است.
هر تلاش پرداخت شناسه مستقل دارد. مبلغ، وضعیت بانکی و شماره پیگیری در کنار سفارش ثبت می‌شوند. گزارش پرداخت‌ها، ابزار بررسی مدیر و پیگیری خودکار به تیم فروش کمک می‌کنند گفت‌وگو با مشتری را با اطلاعات روشن‌تری پیش ببرند. اختلال شبکه یا پاسخ دیرهنگام بانک همچنان ممکن است رخ دهد؛ افزونه آن را به‌عنوان وضعیت قابل بررسی مدیریت می‌کند.
امکاناتی برای مشتری، مدیر فروشگاه و تیم فنی
از نمایش درگاه در تسویه‌حساب تا پیگیری سفارش و خروجی گزارش، ابزارهای مشترک در یک بسته مستقل در دسترس‌اند.
تسویه‌حساب کلاسیک و بلوکی
درگاه در فرم کلاسیک، Checkout Blocks و صفحه پرداخت سفارش (Order Pay) قابل استفاده است. نام، توضیح و نمایش لوگو از تنظیمات کنترل می‌شوند.
گزارش یکپارچه پرداخت‌ها
از مسیر ووکامرس ← گزارش پرداخت‌ها، آخرین وضعیت هر سفارش را همراه با مشخصات خریدار، روش پرداخت، مبلغ و شماره پیگیری ببینید؛ گزارش به این درگاه محدود نیست.
پیگیری نتیجه‌های نامشخص
قطع ارتباط، به معنی شکست قطعی پرداخت نیست. وضعیت‌های قابل پیگیری تا ۶ نوبت بازبینی می‌شوند؛ مدیر نیز ابزار بررسی دستی دارد. اجرای صف و Cron سایت باید برقرار باشد.
کنترل پرداخت تکراری
قفل سفارش و دفتر تلاش‌های پرداخت از پردازش هم‌زمان و تکرار ناخواسته جلوگیری می‌کنند. در نسخه ۵.۵.۵، تراکنش نامشخص در هر یک از شش درگاه این خانواده پیش از ساخت تلاش جدید بررسی می‌شود؛ تعویض روش پرداخت، وضعیت باز قبلی را دور نمی‌زند.
مبلغ ریالی بدون اعشار شناور
ریال، تومان، هزار ریال و هزار تومان با تبدیل صحیح به ریال پشتیبانی می‌شوند. مبلغ صفر، ارز ناسازگار، سرریز عددی و کسری نامعتبر ریال رد می‌شوند.
سازگاری با HPOS و سفارش‌های قدیمی
اطلاعات سفارش با WooCommerce CRUD خوانده و نوشته می‌شود؛ افزونه برای HPOS و ذخیره‌سازی قدیمی سفارش‌ها طراحی شده است.
رمزنگاری اطلاعات محرمانه
اطلاعات اتصال با AES-256-GCM و کلید مشتق‌شده از Salt وردپرس محافظت می‌شوند. برای مدیریت فنی، تعریف اطلاعات در ثابت‌های wp-config نیز در نظر گرفته شده است.
کنترل نگه‌داری گزارش‌ها
مدت پیش‌فرض گزارش ۳۰ روز است. مقدار صفر نگه‌داری دائمی و بازه ۱ تا ۳۶۵۰ روز نگه‌داری محدود را تعیین می‌کند؛ گزارش منقضی از نمایش و CSV کنار گذاشته می‌شود.
خروجی CSV فارسی و قابل استفاده
خروجی تمام نتایج فیلترشده را پوشش می‌دهد. UTF-8 BOM، حفظ صفر ابتدای موبایل و شناسه‌های طولانی و محافظت در برابر فرمول‌های خطرناک در خروجی لحاظ شده‌اند.
تکمیل سفارش با مسیر استاندارد
پس از نتیجه معتبر، payment_complete ووکامرس اجرا می‌شود تا تغییر وضعیت، موجودی و دسترسی دانلود از مسیر استاندارد فروشگاه دنبال شوند.
پیام‌های قابل تنظیم
متن موفقیت با {reference} و متن خطا با {error} قابل تنظیم است. زمان انتظار، حدود مبلغ، لوگو و ثبت رخداد فنی نیز قابل کنترل‌اند.
بسته مستقل و سبک
هر بانک ZIP مستقل دارد؛ برای استفاده از یک درگاه، نصب پنج بسته دیگر لازم نیست. شش درگاه از هسته مشترک تنظیمات، گزارش، HPOS و Checkout Blocks استفاده می‌کنند و قابلیت‌های قراردادی هر بانک جدا باقی می‌مانند.
نسخه هر شش درگاه یکسان شده است. پنل تنظیمات، گزارش پرداخت‌ها، خروجی CSV، پشتیبانی HPOS و تسویه‌حساب بلوکی از منبع مشترک ساخته می‌شوند. کنترل تراکنش نامشخص بین شش درگاه هماهنگ است؛ شناسه‌ها و داده‌های قبلی درگاه‌های همین خانواده حفظ شده‌اند. قابلیت بانکی هر بسته همچنان مطابق سرویس و قرارداد خودش است.
مسیر بانکی و امکانات اختصاصی درگاه ملت
اتصال مستقیم به به‌پرداخت ملت
درخواست پرداخت با bpPayRequest ساخته می‌شود. پس از بازگشت مشتری، Verify و سپس Settle انجام می‌شود؛ وضعیت سفارش فقط با نتیجه معتبر مسیر بانکی تکمیل می‌شود.
تسهیم وجه تا ۱۰ حساب
برای قراردادهای فعال، سرویس تجمعی نوع ۲ می‌تواند مبلغ را میان حداکثر ۱۰ حساب زیرخدمت تقسیم کند. درصدها تا دو رقم اعشار پذیرفته می‌شوند و جمع آن‌ها باید ۱۰۰ درصد باشد.
استرداد کامل یا جزئی
بازپرداخت آنلاین با bpRefundRequest، به فعال بودن گزینه بازپرداخت در افزونه و مجوز قرارداد پذیرندگی وابسته است. مبلغ با مانده قابل استرداد تطبیق داده می‌شود؛ نتیجه نامشخص نیازمند بررسی بانکی است.
اطلاعات تکمیلی پذیرنده
زبان صفحه بانک، شناسه پرداخت‌کننده (Payer ID)، نام و نشانی پذیرنده و اطلاعات سبد خرید قابل تنظیم‌اند. ارسال شماره موبایل مشتری اختیاری و در حالت پیش‌فرض خاموش است.
| موضوع | جزئیات کاربردی |
|---|---|
| روش ارتباط | SOAP؛ افزونه PHP SOAP باید روی سرور فعال باشد. |
| مراحل بانکی | bpPayRequest → bpVerifyRequest → bpSettleRequest؛ در شرایط لازم، استعلام (Inquiry) یا برگشت تراکنش تأییدنشده (Reversal) انجام می‌شود. |
| تأییدهای تکراری | کدهای ۴۳ و ۴۵ در منطق تأیید و تسویه بررسی می‌شوند تا پاسخ «قبلاً انجام شده» بی‌دلیل به پرداخت دوباره منجر نشود. |
| کنترل پاسخ | RefId، شماره سفارش بانکی و مبلغ نهایی در صورت وجود با اطلاعات ثبت‌شده تطبیق داده می‌شوند. |
| تسهیم | تا ۱۰ زیرخدمت، با مجوز بانک؛ شناسه حساب، درصد و شناسه پرداخت‌کننده در تنظیمات تعریف می‌شوند. |
| بازپرداخت | استرداد آنلاین کامل یا جزئی فقط در قرارداد مجاز؛ برای نتیجه نامشخص، درخواست دوباره خودکار ارسال نمی‌شود. |
پیگیری پرداخت نامشخص، بدون فرض کردن شکست یا موفقیت
قطع ارتباط؛ نتیجه هنوز روشن نیست
اگر درخواست بانکی به زمان انتظار برسد (Timeout)، نتیجه فوراً شکست قطعی فرض نمی‌شود. تلاش و مرحله‌ای که قطع شده ثبت می‌شوند تا استعلام یا بررسی بعدی بر اساس اطلاعات موجود انجام شود.
پیگیری خودکار و اقدام مدیر
در صورت فعال بودن، وضعیت‌های قابل پیگیری تا ۶ نوبت از طریق صف زمان‌بندی دنبال می‌شوند. مدیر نیز می‌تواند از اقدام بررسی پرداخت در سفارش استفاده کند؛ برخی پاسخ‌ها به بررسی پنل بانک نیاز دارند.
قفل سفارش و جلوگیری از تکرار
قفل مبتنی بر MySQL GET_LOCK، تلاش‌های هم‌زمان را هماهنگ می‌کند. تراکنش حل‌نشده در خانواده این شش درگاه، پیش از ایجاد پرداخت جدید بررسی می‌شود؛ پرداخت تکمیل‌شده دوباره پردازش نمی‌شود.
ثبت پایدار نتیجه بانکی
اگر بانک وصول را تأیید کند اما اجرای تکمیل سفارش قطع شود، دفتر تراکنش‌ها (Ledger) نتیجه بانکی را نگه می‌دارد. مسیر بازیابی می‌تواند تکمیل سفارش را پیگیری کند، بدون شروع یک برداشت تازه.
گزارش پرداخت‌ها؛ از پیدا کردن سفارش تا خروجی حسابداری
در بخش «ووکامرس ← گزارش پرداخت‌ها»، برای هر سفارش یک ردیف از آخرین وضعیت نگه‌داری می‌شود. نام و نام خانوادگی، ایمیل، موبایل، تاریخ تراکنش، مبلغ و ارز، روش پرداخت، وضعیت سفارش و مبلغ استردادشده کنار شماره سفارش و شناسه پیگیری قرار می‌گیرند. این جدول، تاریخچه همه تلاش‌های یک سفارش نیست؛ تلاش‌های بانکی در دفتر تراکنش جدا ثبت می‌شوند.
جست‌وجو و فیلتر عملی
با شماره سفارش، نام، ایمیل، موبایل یا شماره پیگیری جست‌وجو کنید. فیلتر روش پرداخت، وضعیت و تاریخ در دسترس است؛ صفحه‌بندی ۲۵ ردیفی، بررسی را منظم می‌کند. ورودی فیلتر تاریخ میلادی است و نمایش زمان از تنظیمات سایت پیروی می‌کند.
خروجی مناسب فایل‌های بزرگ
CSV همه نتایج فیلترشده را در دسته‌های ۵۰۰ ردیفی پردازش می‌کند. فارسی با UTF-8 BOM صادر می‌شود و موبایل و شناسه‌های طولانی به‌صورت متن حفظ می‌شوند تا صفر ابتدایی یا رقم‌ها در صفحه‌گسترده تغییر نکنند.
نگه‌داری و پاک‌سازی کنترل‌شده
مدت پیش‌فرض ۳۰ روز است و از اولین ثبت رکورد گزارش محاسبه می‌شود. رکورد منقضی حتی اگر اجرای پاک‌سازی عقب افتاده باشد در جدول و CSV نمایش داده نمی‌شود. حذف فیزیکی در دسته‌های محدود انجام می‌شود.
اضافه کردن سفارش‌های قبلی
با «افزودن / به‌روزرسانی سوابق قبلی»، سفارش‌های موجود در دسته‌های ۱۰۰تایی خوانده می‌شوند. بازه نگه‌داری رعایت می‌شود و ردیف تکراری ساخته نمی‌شود. برای ادامه پردازش، صف زمان‌بندی سایت باید اجرا شود.
اگر هر شش درگاه نصب باشند، گزارش از یک جدول مشترک استفاده می‌کند و سه ردیف تکراری برای یک سفارش ایجاد نمی‌شود. دسترسی مدیریتی و خروجی با مجوز manage_woocommerce و کنترل درخواست معتبر (Nonce) محدود شده است. ابزارهای حریم خصوصی وردپرس نیز برای داده‌های گزارش و ایمیل صورتحساب در نظر گرفته شده‌اند.
تنظیمات مهم، با واحد و مقدار پیش‌فرض روشن
| موضوع | جزئیات کاربردی |
|---|---|
| اطلاعات پذیرندگی | شماره ترمینال، نام کاربری و رمز سرویس به‌پرداخت ملت؛ از قرارداد و پنل رسمی پذیرنده دریافت شود. |
| فعال‌سازی درگاه | در حالت پیش‌فرض خاموش است؛ پس از تکمیل اطلاعات و آزمون فعال شود. |
| عنوان، توضیح و لوگو | متن نمایش در تسویه‌حساب قابل تغییر است؛ نمایش لوگو به‌صورت پیش‌فرض فعال است. |
| زمان انتظار پاسخ | ۱۵ ثانیه پیش‌فرض؛ بازه قابل تنظیم ۵ تا ۳۰ ثانیه. افزایش این عدد، در دسترس بودن بانک را تضمین نمی‌کند. |
| حداقل و حداکثر مبلغ | حداقل پیش‌فرض ۱۰۰۰ ریال است. حداکثر صفر یعنی افزونه سقف محلی تعیین نمی‌کند؛ محدودیت بانک همچنان برقرار است. |
| واحد پول | IRR، IRT، IRHR و IRHT؛ تبدیل به ریال با ضرایب ۱، ۱۰، ۱۰۰۰ و ۱۰۰۰۰. |
| پیگیری خودکار | پیش‌فرض فعال؛ سقف ۶ نوبت برای وضعیت‌های قابل پیگیری، با نیاز به اجرای صف سایت. |
| گزارش فنی Debug | پیش‌فرض خاموش؛ ثبت رخداد محدود در WooCommerce Logger برای عیب‌یابی. با جدول گزارش پرداخت‌ها متفاوت است. |
| مدت گزارش پرداخت‌ها | ۳۰ روز پیش‌فرض؛ صفر دائمی؛ ۱ تا ۳۶۵۰ روز برای نگه‌داری محدود. |
| پیام موفقیت و خطا | متن قابل تنظیم؛ {reference} برای شماره مرجع و {error} برای توضیح خطا. |
اگر اطلاعات اتصال را در wp-config تعریف کرده باشید، ثابت‌ها نسبت به مقادیر ذخیره‌شده اولویت دارند. خالی گذاشتن فیلد رمز هنگام ویرایش، رمز قبلی را نگه می‌دارد. پس از تغییر Saltهای وردپرس، اطلاعات رمزنگاری‌شده باید دوباره وارد شوند.
مثال‌های عملی؛ این ابزار در فروشگاه کجا کمک می‌کند؟
سناریوهای زیر نمونه آموزشی‌اند و گزارش عملکرد یک مشتری واقعی نیستند. هدف، نشان دادن مسیر استفاده در عملیات روزانه فروشگاه است.
فروشگاه پوشاک؛ پاسخ به مشتری با شماره پیگیری
مشتری می‌گوید مبلغ از حسابش کم شده ولی سفارش تکمیل نشده است. تیم پشتیبانی شماره سفارش یا موبایل را در گزارش جست‌وجو می‌کند، مرحله بانکی را می‌بیند و در صورت نامشخص بودن، بررسی پرداخت را انجام می‌دهد. درخواست پرداخت دوباره پیش از روشن شدن نتیجه توصیه نمی‌شود.
فروشگاه موبایل و سخت‌افزار؛ تطبیق روزانه
مسئول مالی پرداخت‌های یک روش را در بازه تاریخ مشخص فیلتر و CSV تمام نتایج را دریافت می‌کند. شماره پیگیری و مبلغ برای تطبیق با گزارش پذیرنده در دسترس‌اند. گزارش افزونه جایگزین صورتحساب بانک یا سیستم حسابداری نیست.
فروش فایل و آموزش؛ تحویل پس از تأیید
پس از تأیید معتبر، مسیر استاندارد payment_complete اجرا می‌شود و دسترسی دانلود بر اساس تنظیمات ووکامرس فراهم می‌شود. اگر تأیید نامشخص باشد، تحویل فایل نباید صرفاً بر اساس پیام مرورگر یا ادعای مشتری انجام شود.
فروشگاه بزرگ؛ هماهنگی با Checkout Blocks
تیم فنی می‌تواند درگاه را در تسویه‌حساب بلوکی و HPOS بررسی کند. هم‌زمانی درخواست‌ها و تلاش‌های پرداخت، با قفل سفارش و دفتر ثبت تلاش‌ها مدیریت می‌شوند. آزمون روی قالب و افزونه‌های فعال همان فروشگاه ضروری است.
یک سناریوی اختصاصی برای ملت
فروشگاهی با دو مجموعه همکار را در نظر بگیرید که قرارداد تسهیم ملت برای آن فعال شده است. سهم فروش و خدمات را به‌صورت ۷۰ و ۳۰ درصد تعریف می‌کند. افزونه درصدها را کنترل و سهم ریالی را محاسبه می‌کند؛ اختلاف گرد کردن سهم آخر نیز اصلاح می‌شود. این مثال به مجوز بانک وابسته است و جایگزین حسابداری یا قرارداد میان شرکا نیست.
اطلاعات بانکی، منابع سرور و محدودیت‌ها
اطلاعات کارت وارد سایت نمی‌شود
مشتری اطلاعات کارت را در صفحه بانک وارد می‌کند. افزونه شماره کامل کارت، رمز کارت یا CVV2 ذخیره نمی‌کند. اگر سرویس شماره کارت پوشیده‌شده (Masked PAN) بدهد، فقط همان داده محدود در مسیر مربوط استفاده می‌شود.
پاسخ مرورگر با شواهد سرور بررسی می‌شود
هر تلاش UUID و وضعیت HMAC مستقل دارد. پاسخ بازگشت با سفارش و اطلاعات ثبت‌شده تطبیق داده می‌شود و اعتبارسنجی TLS برای ارتباط با بانک فعال است. وابستگی به نشست PHP برای تشخیص پرداخت وجود ندارد.
بارگذاری فایل‌ها در جای مورد نیاز
دارایی‌های تسویه‌حساب بلوکی و مدیریت به بخش مرتبط محدود شده‌اند و لوگوها محلی‌اند. فایل نصب کوچک است، اما سرعت نهایی پرداخت به میزبان، شبکه، بانک، صف سایت و سایر افزونه‌ها نیز وابسته است.
رشد داده‌ها را مدیریت کنید
گزارش پرداخت و دفتر تراکنش داده ایجاد می‌کنند. مدت نگه‌داری گزارش و پردازش دسته‌ای به مدیریت این بخش کمک می‌کنند. پاک‌سازی گزارش، آرشیو مالی سفارش یا دفتر بانکی را حذف نمی‌کند.
در مستندات پروژه، آزمون‌های خودکار مسیر مالی، HPOS و ذخیره‌سازی قدیمی، Checkout Blocks، گزارش و CSV با پاسخ‌های کنترل‌شده ثبت شده‌اند. این آزمون‌ها معادل تأیید رسمی بانک یا انجام تراکنش واقعی پذیرندگی نیستند؛ آزمون زنده کم‌مبلغ روی قرارداد خودتان همچنان لازم است.
آموزش کوتاه نصب و راه‌اندازی
| موضوع | جزئیات کاربردی |
|---|---|
| وردپرس و ووکامرس | وردپرس ۶.۸ یا بالاتر؛ ووکامرس ۱۰.۰ یا بالاتر. |
| PHP | نسخه ۸.۳ یا بالاتر، محیط ۶۴ بیتی و OpenSSL. |
| پایگاه‌داده | MySQL یا MariaDB با امکان استفاده از GET_LOCK. |
| ارتباط بانکی | HTTPS معتبر، ارتباط خروجی سرور با بانک و IP و دامنه ثبت‌شده در قرارداد. |
| SOAP | برای این درگاه لازم است. |
| صف و Cron | اجرای زمان‌بندی سایت برای پیگیری خودکار، وارد کردن سوابق و پاک‌سازی گزارش. |
| پذیرندگی | شماره ترمینال، نام کاربری و رمز سرویس به‌پرداخت ملت و قرارداد فعال خرید اینترنتی. |
- بسته ZIP همین محصول را دریافت کنید. فایل را از «افزونه‌ها ← افزودن افزونه ← بارگذاری افزونه» نصب و سپس فعال کنید.
- به «ووکامرس ← پیکربندی ← پرداخت‌ها» بروید و درگاه ملت را باز کنید.
- اطلاعات پذیرندگی را دقیقاً مطابق سرویس قرارداد وارد کنید. واحد پول فروشگاه، HTTPS، دامنه بازگشت و IP خروجی سرور را بررسی کنید.
- عنوان و توضیح درگاه، پیام نتیجه، زمان انتظار و حدود مبلغ را تنظیم کنید. قابلیت‌های وابسته به قرارداد را فقط پس از تأیید بانک فعال کنید.
- یک سفارش کم‌مبلغ بسازید و مسیر پرداخت، بازگشت از بانک، شماره مرجع و وضعیت سفارش را بررسی کنید. انصراف مشتری و مسیر خطا را نیز آزمایش کنید.
- «ووکامرس ← گزارش پرداخت‌ها» را باز کنید؛ جست‌وجو، فیلتر و CSV را بررسی کنید. در صورت نیاز، سوابق قبلی را به صف اضافه کنید.
- پس از اطمینان از تنظیمات، درگاه را برای مشتریان در دسترس قرار دهید و اجرای صف، گزارش خطا و تطبیق بانکی را در برنامه نگه‌داری فروشگاه قرار دهید.
جزئیات مفید برای توسعه‌دهنده و تیم پشتیبانی
هر بسته مستقل است و شناسه درگاه آن wpwm_mellat است. اطلاعات سفارش از WooCommerce CRUD عبور می‌کنند و کلیدهای متادیتای درخواست، تأیید، مرجع، وضعیت‌ها و تلاش پرداخت در فایل META.md مستند شده‌اند. برای توسعه و عیب‌یابی، README.md و META.md بسته را بررسی کنید؛ اطلاعات محرمانه سرویس را در خروجی عمومی یا لاگ سفارشی نمایش ندهید.
برای کاربردهای سفارشی، فیلترهای wpwm_mellat_payer_id و wpwm_mellat_split_accounts وجود دارند. استفاده از آن‌ها به شناخت قرارداد بانکی و آزمون خروجی نیاز دارد؛ فیلتر، مجوز تسهیم یا استرداد ایجاد نمی‌کند.
برای گزارش روش‌های پرداخت دیگر، وضعیت سفارش ووکامرس مبناست. افزونه اشتراک و پرداخت دوره‌ای خودکار، ذخیره کارت، برداشت بدون حضور مشتری یا سرویس انتقال وجه کارت‌به‌کارت ارائه نمی‌کند. سازگاری عمومی با هر افزونه سفارشی بدون آزمون همان محیط قابل نتیجه‌گیری نیست.
سؤالات متداول درگاه ملت ووکامرس
افزونه درگاه پرداخت ملت واقعاً رایگان است؟
بله؛ قیمت دریافت فایل افزونه صفر است و لایسنس تجاری برای فعال‌سازی ندارد. پذیرندگی، کارمزد و تسویه بانکی تابع قرارداد شرکت پرداخت هستند.
برای راه‌اندازی درگاه ملت چه چیزی لازم دارم؟
شماره ترمینال، نام کاربری و رمز سرویس به‌پرداخت ملت، ووکامرس فعال، HTTPS و هاست سازگار لازم است. اطلاعات باید مربوط به دامنه و IP مجاز همان پذیرندگی باشد؛ سپس مسیر یک خرید کوچک را بررسی کنید.
نسخه جدید درگاه ملت مشکل افزونه قدیمی را حل می‌کند؟
این بسته برای نسخه‌های جدید وردپرس و ووکامرس و هر دو روش تسویه‌حساب ساخته شده است. اگر مشکل از نبود پشتیبانی Blocks یا HPOS باشد، قابلیت مربوط در این افزونه وجود دارد؛ خطای پذیرندگی، کش مسیر بازگشت یا اختلال شبکه نیازمند رفع علت خودش است. سازگاری ترکیب افزونه‌های فروشگاه را آزمایش کنید.
دانلود رایگان یعنی کارمزد بانکی هم صفر است؟
قیمت فایل افزونه صفر است. کارمزد، شرایط پذیرندگی، تسویه و سرویس‌های ویژه تابع قرارداد بانک هستند و با دانلود این محصول تغییر نمی‌کنند.
برای چند سایت می‌توانم نصب کنم؟
این بسته با مجوز GPL-2.0-or-later ارائه شده و سامانه لایسنس تجاری یا محدودیت فعال‌سازی دامنه در کد آن وجود ندارد. اطلاعات پذیرندگی و دامنه مجاز هر سایت را باید مطابق قرارداد بانک تنظیم کنید.
آیا با تسویه‌حساب بلوکی و HPOS کار می‌کند؟
پشتیبانی از Checkout Blocks، تسویه‌حساب کلاسیک، Order Pay و HPOS در کد افزونه وجود دارد. سازگاری را با قالب، نسخه‌ها و افزونه‌های فعال فروشگاه خودتان بررسی کنید.
تومان پشتیبانی می‌شود؟
بله؛ IRR، IRT، IRHR و IRHT با تبدیل دقیق به ریال پشتیبانی می‌شوند. حداقل و حداکثر مبلغ تنظیمات با واحد ریال بررسی می‌شوند؛ ارز دیگر بدون پشتیبانی صریح پذیرفته نمی‌شود.
چرا درگاه در تسویه‌حساب نمایش داده نمی‌شود؟
فعال بودن درگاه، کامل بودن اطلاعات پذیرندگی، پیش‌نیازهای PHP، HTTPS، واحد پول و قرار گرفتن مبلغ در محدوده مجاز را بررسی کنید. عنوان یا لوگو به‌تنهایی نشانه آماده بودن اتصال بانکی نیست.
اگر پول کم شود ولی سفارش پرداخت‌نشده بماند چه کنم؟
شماره سفارش و مرحله تراکنش را بررسی کنید. از ابزار بررسی پرداخت و پنل پذیرنده برای روشن شدن نتیجه استفاده کنید. پرداخت دوباره یا تکمیل دستی سفارش را پیش از تطبیق شواهد بانکی انجام ندهید.
گزارش، همه تلاش‌های پرداخت را نشان می‌دهد؟
خیر. گزارش پرداخت‌ها یک ردیف از آخرین وضعیت هر سفارش دارد. تلاش‌های بانکی و مراحل پیگیری در دفتر تراکنش جدا ثبت می‌شوند.
CSV فقط همان صفحه را خروجی می‌گیرد؟
خیر. تمام نتایج فیلترشده صادر می‌شوند، با پردازش دسته‌ای برای کنترل مصرف حافظه. شماره‌ها و موبایل به‌صورت متن حفظ می‌شوند و خروجی فارسی UTF-8 BOM دارد.
کاهش زمان نگه‌داری، سفارش‌ها را حذف می‌کند؟
خیر. فقط ردیف‌های گزارش مشمول حذف‌اند؛ سفارش‌ها، متادیتای بانکی و دفتر تراکنش حذف نمی‌شوند. داده گزارش که قبلاً حذف شده با تغییر مقدار به صفر بازنمی‌گردد.
هر شش افزونه را می‌توان هم‌زمان نصب کرد؟
بله، بسته‌ها و شناسه درگاه مستقل‌اند. گزارش پرداخت‌ها جدول مشترک دارد و از ایجاد ردیف تکراری برای یک سفارش جلوگیری می‌شود. تراکنش حل‌نشده پیش از تلاش جدید در این خانواده درگاه‌ها بررسی می‌شود.
آیا این افزونه پرداخت دوره‌ای خودکار دارد؟
خیر. برداشت دوره‌ای خودکار، ذخیره کارت یا تمدید خودکار با برداشت بانکی در این محصول پیاده‌سازی نشده است.
آیا بازپرداخت مستقیم از ووکامرس انجام می‌شود؟
درگاه ملت این قابلیت را دارد، اما باید بازپرداخت در تنظیمات فعال و در قرارداد بانکی مجاز باشد. بازپرداخت کامل و جزئی، شماره مرجع و مانده سفارش کنترل می‌شوند. اگر پاسخ بانک نامشخص باشد، ابتدا پنل بانک را بررسی کنید؛ تکرار درخواست می‌تواند به استرداد دوباره منجر شود.
تسهیم برای هر ترمینالی فعال است؟
خیر. سرویس نوع ۲ و حساب‌های زیرخدمت باید از طرف به‌پرداخت برای پذیرنده فعال شده باشند. تنها وارد کردن درصد و شناسه در افزونه، مجوز بانکی ایجاد نمی‌کند.
اگر تأیید انجام شود ولی تسویه قطع شود چه می‌شود؟
وضعیت مرحله بانکی ثبت می‌شود و افزونه در شرایط مجاز آن را پیگیری می‌کند. تا زمانی که نتیجه معتبر روشن نشده باشد، تکمیل سفارش قطعی فرض نمی‌شود. بعضی وضعیت‌ها نیازمند بررسی پنل بانک یا اقدام مدیر هستند.