درگاه پارسیان کدنما | افزونه پرداخت ووکامرس

درگاه پارسیان ووکامرس با پنل فارسی کدنما

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

این افزونه برای فروشگاه‌هایی مناسب است که پذیرندگی فعال پارسیان دارند و می‌خواهند کنترل روشن‌تری بر نتیجه پرداخت داشته باشند. سفارش زمانی پرداخت‌شده ثبت می‌شود که تأیید معتبر بانک دریافت و با اطلاعات ذخیره‌شده همان درخواست تطبیق داده شود. در ادامه، امکانات نسخه ۱.۰.۰، پیش‌نیازها و روش استفاده را به‌صورت کامل می‌خوانید.

۱. پنل مدرن، فارسی و راست‌چین

پنل اختصاصی درگاه پارسیان ووکامرس از چهار بخش پیشخوان، تنظیمات درگاه، تراکنش‌ها و راهنمای شروع تشکیل شده است. کارت‌های وضعیت، نشان‌های رنگی، فاصله‌گذاری خوانا، فرم‌های مرتب و دسترسی مستقیم به تنظیمات پرداخت ووکامرس، مدیریت روزانه را منظم می‌کنند. چیدمان واکنش‌گرا در نمایشگر کوچک نیز قابل استفاده است.

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

۲. پیشخوان آمادگی و وضعیت پرداخت‌ها

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

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

۳. فعال‌سازی و آزمون ویژه مدیران

مدیر می‌تواند درگاه را از تنظیمات اختصاصی فعال یا غیرفعال کند. گزینه «نمایش فقط برای مدیران» اجازه می‌دهد روش پرداخت در مرحله راه‌اندازی برای کاربران دارای مجوز مدیریت نمایش داده شود. پس از آزمون روی دامنه مجاز، با خاموش کردن این گزینه می‌توان درگاه را در اختیار مشتریان قرار داد.

این گزینه، دسترسی به روش پرداخت را محدود می‌کند و سندباکس یا پرداخت شبیه‌سازی‌شده بانک نیست. خریدی که از طریق پذیرندگی واقعی انجام می‌شود، یک تراکنش واقعی است. در نصب اولیه، درگاه غیرفعال و نمایش ویژه مدیران روشن است تا مدیر ابتدا اتصال و تنظیمات را تکمیل کند.

۴. اطلاعات پذیرنده و مدیریت محرمانگی

برای اتصال، PIN یا LoginAccount دریافتی از پارسیان در فرم تنظیمات وارد می‌شود. این شناسه ممکن است با شماره پذیرنده تفاوت داشته باشد؛ باید همان اطلاعات وب‌سرویس ارائه‌شده توسط شرکت پرداخت ثبت شود. مقدار ذخیره‌شده دوباره داخل فرم نمایش داده نمی‌شود و دکمه نمایش، تنها ورودی جدید را آشکار می‌کند.

خالی گذاشتن فیلد هنگام ذخیره، اطلاعات قبلی را حفظ می‌کند. پس از ثبت شناسه، امکان حذف اطلاعات ذخیره‌شده نیز وجود دارد؛ حذف آن روش پرداخت را غیرفعال می‌کند. اطلاعات پذیرنده با AES-256-GCM و کلید مشتق‌شده از تنظیمات امنیتی وردپرس رمز می‌شود و در کد جاوااسکریپت، گزارش یا فایل CSV قرار نمی‌گیرد.

۵. اتصال به وب‌سرویس پارسیان و صفحه بانک

درگاه پارسیان ووکامرس درخواست فروش را با سرویس SalePaymentRequest ایجاد می‌کند و مشتری را با توکن همان درخواست به صفحه پرداخت پارسیان می‌فرستد. ارتباط سرور با نشانی‌های مشخص وب‌سرویس پارسیان از طریق HTTPS انجام می‌شود و اعتبارسنجی گواهی ارتباط روشن است.

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

۶. تأیید پرداخت با تطبیق مبلغ و شناسه درخواست

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

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

۷. محاسبه دقیق ریال، تومان و واحدهای هزار

واحدهای IRR، IRT، IRHR و IRHT پشتیبانی می‌شوند؛ یعنی ریال، تومان، هزار ریال و هزار تومان. مبلغ ارسالی به بانک همواره ریال است. برای نمونه، سفارش ۶۵۰ هزار تومانی با واحد IRT به مبلغ ۶ میلیون و ۵۰۰ هزار ریال تبدیل می‌شود. وضعیت واحد پول فعلی نیز در تنظیمات نمایش داده می‌شود.

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

۸. تنظیم عنوان، توضیح و پیام‌های پرداخت

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

پیام پرداخت موفق و پیام پرداخت تأییدنشده نیز قابل تنظیم‌اند. برای مثال، پیام موفقیت می‌تواند ثبت پرداخت را اعلام کند و پیام تأییدنشده، مشتری را به پشتیبانی فروشگاه راهنمایی کند. نمایش پیام موفقیت همچنان وابسته به تأیید واقعی پردازش است؛ تغییر متن پیام، نتیجه مالی تراکنش را تغییر نمی‌دهد.

۹. دفتر مستقل تلاش‌های پرداخت

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

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

۱۰. فیلتر تراکنش و خروجی CSV

صفحه تراکنش‌ها امکان فیلتر بر اساس وضعیت و شماره سفارش را دارد. فهرست با صفحه‌بندی و ۲۰ ردیف در هر صفحه ارائه می‌شود تا مرور سوابق طولانی راحت‌تر باشد. مدیر می‌تواند از گزارش کلی به درخواست‌های یک سفارش یا موارد نیازمند پیگیری برسد.

خروجی CSV تا ۵۰۰۰ درخواست اخیر را برای بررسی و بایگانی فراهم می‌کند. فایل با UTF-8 و نشان BOM ساخته می‌شود تا متن فارسی در نرم‌افزارهایی مانند اکسل بهتر خوانده شود. اطلاعات محرمانه پذیرنده، شماره کارت و توکن بانک در خروجی قرار نمی‌گیرند. داده‌های متنی خروجی نیز در برابر تفسیر به‌عنوان فرمول صفحه‌گسترده محافظت می‌شوند.

۱۱. کنترل درخواست هم‌زمان و بازگشت تکراری

برای هر سفارش، قفل پایگاه داده فرایند ایجاد و تأیید را هماهنگ می‌کند. اگر مشتری درخواست پرداخت منتظر را دوباره باز کند، توکن همان تلاش قابل استفاده است و درخواست تازه هم‌زمان ساخته نمی‌شود. شناسه یکتای توکن و شماره پیگیری نیز مانع استفاده از یک رسید برای پرداخت دو سفارش می‌شود.

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

۱۲. بازیابی ثبت سفارش و پیگیری از بانک

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

در تراکنش قابل پیگیری، مدیر دارای مجوز می‌تواند از گزینه «پیگیری از بانک» استفاده کند. این عملیات با بررسی دسترسی و کد امنیتی فرم انجام می‌شود. اگر پاسخ اولیه نامشخص باشد، سفارش بی‌دلیل پرداخت‌شده فرض نمی‌شود و ساخت تلاش جدید برای همان سفارش تا روشن شدن وضعیت قبلی متوقف می‌ماند.

۱۳. رسید مشتری و هماهنگی با سفارش ووکامرس

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

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

۱۴. تسویه‌حساب کلاسیک و ثبت روش بلوکی

درگاه در فهرست روش‌های پرداخت ووکامرس ثبت می‌شود و تنظیمات آن از بخش پرداخت‌های ووکامرس نیز در دسترس است. برای تسویه‌حساب کلاسیک، کلاس درگاه ووکامرس و برای تسویه‌حساب بلوکی، کلاس اتصال و اسکریپت معرفی روش پرداخت پیاده‌سازی شده‌اند.

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

۱۵. کنترل خطا و حفاظت از پردازش پاسخ

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

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

۱۶. نصب و راه‌اندازی درگاه پارسیان ووکامرس

فایل ZIP نصب و راهنمای فارسی همراه محصول ارائه می‌شود. ابتدا در وردپرس از مسیر افزونه‌ها، افزودن و بارگذاری افزونه، فایل را نصب و فعال کنید. ووکامرس باید فعال باشد. سپس منوی «درگاه پارسیان» و تب «تنظیمات درگاه» را باز کنید، PIN / LoginAccount معتبر را وارد و عنوان و توضیح را تنظیم کنید.

دامنه و IP سرور باید نزد پارسیان مجاز باشند و سایت واقعی HTTPS معتبر داشته باشد. آدرس پایه بازگشت در پنل نمایش داده می‌شود؛ شناسه و کد امن هر تلاش به آن افزوده خواهد شد. این مسیر را از کش و قوانین مسدودکننده بازگشت بانک مستثنا کنید. راهنمای شروع در پنل، مراحل نصب و نکات پیگیری را کنار تنظیمات نگه می‌دارد.

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

۱۷. پیش‌نیازها، دریافت پذیرندگی و پشتیبان‌گیری

حداقل نسخه موردنیاز، وردپرس ۶.۵، ووکامرس ۸.۵ و PHP ۸.۱ است. سرور به DOM/XML و OpenSSL با پشتیبانی AES-GCM نیاز دارد. پایگاه داده MySQL یا MariaDB باید قفل GET_LOCK و جداول InnoDB را پشتیبانی کند. ارتباط خروجی HTTPS با میزبان pec.shaparak.ir و گواهی معتبر فروشگاه برای راه‌اندازی واقعی لازم است.

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

برای بازیابی درست اطلاعات رمز‌شده، از پایگاه داده و فایل wp-config.php با هم پشتیبان بگیرید. تغییر کلیدهای امنیتی وردپرس به ورود دوباره اطلاعات پذیرنده و بررسی درخواست‌های باز نیاز دارد. این نکته در راهنمای همراه محصول توضیح داده شده است تا انتقال فروشگاه و بازیابی نسخه پشتیبان با اطلاعات کامل انجام شوند.

۱۸. دامنه نسخه و آزمون‌های انجام‌شده

نسخه ۱.۰.۰ برای پرداخت خرید ووکامرس ساخته شده است. استرداد خودکار وجه، پرداخت دوره‌ای، تسهیم، ذخیره توکن کارت و خرید یک‌کلیکی در این نسخه ارائه نمی‌شوند. مدیریت استرداد بانکی و نتیجه موارد مبهم باید مطابق روال پذیرنده و امکانات فروشگاه انجام شود.

آزمون داخلی در محیط وردپرس ۷.۱.۲، ووکامرس ۱۱.۱.۲، PHP ۸.۳ و MariaDB ۱۱.۴ انجام شده است. ۷۱ بررسی روی HPOS و همان بررسی‌ها روی ساختار قدیمی سفارش گذرانده شدند؛ در ساختار قدیمی یک بررسی اضافی نیز استفاده واقعی از همان مخزن را تأیید کرد. تبدیل مبلغ، رمزنگاری، بازگشت جعلی و تکراری، تغییر مبلغ، خطای شبکه، پاسخ ناسالم، رسید تکراری، مجوز فرم و کاهش یک‌باره موجودی از موارد آزمون هستند.

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