درگاه پرداخت زرین‌ پال برای Botble CMS | نصب و دانلود افزونه

درگاه پرداخت زرین‌ پال برای Botble CMS؛ نصب، تنظیمات و دانلود

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

برای فروشگاه‌ های Botble که از زرین‌پال استفاده می‌کنند، افزونه ZarinPal Payment Gateway for Botble CMS توسط آریاپورتال توسعه داده شده است. این افزونه با معماری پرداخت Botble Ecommerce هماهنگ می‌ شود و امکان استفاده از زرین‌ پال را در فرآیند پرداخت فروشگاه فراهم می‌ کند.

افزونه از ZarinPal REST API v4 استفاده می‌کند و تنظیماتی مانند Merchant ID، حالت Sandbox و Live، انتخاب تومان یا ریال، پشتیبانی فارسی و انگلیسی و نمایش اطلاعات تراکنش را در اختیار مدیر سایت قرار می‌ دهد.

هدف اصلی افزونه ساده است: افزونه را نصب کنید، اطلاعات درگاه را در تنظیمات Botble وارد کنید و از همان فرآیند پرداخت موجود در Ecommerce برای پرداخت‌ های زرین‌پال استفاده کنید.

چرا یک افزونه اختصاصی زرین‌ پال برای Botble؟

Botble CMS برای فروشگاه اینترنتی، ماژول Ecommerce و معماری مشخصی برای روش‌ های پرداخت دارد. به همین دلیل، اضافه‌ کردن یک درگاه بهتر است به جای ایجاد یک سیستم پرداخت جداگانه، با همین ساختار انجام شود.

این موضوع یکی از نکات اصلی در طراحی افزونه ZarinPal برای Botble بوده است.

افزونه با فرآیند پرداخت موجود در Botble Ecommerce کار می‌ کند. مدیریت سفارش همچنان توسط خود Botble انجام می‌ شود و افزونه وظیفه ارتباط با زرین‌پال را در مرحله پرداخت بر عهده دارد.

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

استفاده از ZarinPal REST API v4

این افزونه برای ارسال درخواست پرداخت و تأیید تراکنش از ZarinPal REST API v4 استفاده می‌ کند.

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

افزونه این فرآیند را در چارچوب درگاه پرداخت Botble مدیریت می‌ کند.

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

انتخاب تومان یا ریال

واحد پول یکی از بخش‌ هایی است که در پروژه‌ های فروشگاهی ایرانی باید به آن توجه ویژه‌ ای داشت.

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

افزونه ZarinPal برای این موضوع تنظیم جداگانه‌ ای در نظر گرفته است.

مدیر سایت می‌ تواند واحد مورد استفاده برای پرداخت زرین‌پال را انتخاب کند:

• تومان (IRT)
• ریال (IRR)

این تنظیم مستقل از برچسب واحد پول عمومی فروشگاه است.

در نتیجه، مدیر یا توسعه‌ دهنده می‌ تواند تنظیم مربوط به درگاه را به‌ صورت مشخص بررسی کند و واحد مورد نظر خود را برای پرداخت انتخاب نماید.

حالت Sandbox و Live

در زمان توسعه یک فروشگاه، معمولاً بهتر است تنظیمات درگاه قبل از استفاده در محیط واقعی بررسی شوند.

افزونه زرین‌پال Botble از دو محیط Sandbox و Live پشتیبانی می‌کند.

محیط مورد نظر از طریق تنظیمات افزونه انتخاب می‌ شود و برای تغییر بین محیط آزمایشی و اصلی نیازی به ویرایش کد افزونه نیست.

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

مدیریت اطلاعات پرداخت هنگام بازگشت کاربر

فرآیند پرداخت زمانی که کاربر سایت را ترک می‌ کند و وارد درگاه می‌ شود، تمام نمی‌ شود.

پس از پایان مرحله پرداخت، کاربر باید به سایت بازگردد و سیستم باید بتواند تراکنش مربوطه را شناسایی کرده و فرآیند تأیید را ادامه دهد.

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

به این ترتیب، هنگام بازگشت کاربر به سایت، اطلاعات لازم برای ادامه فرآیند تراکنش در اختیار سیستم قرار دارد.

اطلاعات تراکنش در پنل مدیریت Botble

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

افزونه اطلاعات تراکنش را در محیط مدیریت در اختیار مدیر سایت قرار می‌ دهد. این اطلاعات می‌تواند شامل مواردی مانند:

• کد پیگیری
• مبلغ پرداخت
• وضعیت تراکنش
• اطلاعات مرتبط با تراکنش

باشد.

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

پشتیبانی از زبان فارسی و انگلیسی

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

این ویژگی برای پروژه‌ هایی که مدیران فارسی‌ زبان دارند یا تیم توسعه آن‌ها ترجیح می‌دهد با محیط انگلیسی کار کند، کاربردی است.

تنظیمات و پیام‌ های مرتبط با درگاه نیز متناسب با این دو زبان در اختیار کاربر قرار می‌ گیرند.

آموزش نصب افزونه زرین‌پال در Botble CMS

نصب افزونه بر اساس ساختار معمول Plugin های Botble انجام می‌ شود.

ابتدا پوشه payment-gateway افزونه را در مسیر زیر قرار دهید:

platform/plugins/

پس از انتقال فایل‌ ها، وارد پنل مدیریت Botble شوید و به بخش:

Admin → Plugins

بروید.

در فهرست افزونه‌ ها، ZarinPal Payment Gateway را پیدا کرده و آن را فعال کنید.

سپس وارد مسیر زیر شوید:

Admin → Settings → Payment → Payment Methods

در این بخش تنظیمات مربوط به زرین‌پال را مشاهده خواهید کرد.

از این قسمت می‌توانید Merchant ID و سایر تنظیمات درگاه را وارد کنید.

نحوه تنظیم Merchant ID زرین‌پال

Merchant ID اطلاعاتی است که افزونه را به حساب Merchant شما در زرین‌ پال متصل می‌ کند.

برای دریافت و تنظیم آن، ابتدا وارد داشبورد زرین‌ پال شوید و بخش Merchants را باز کنید.

در این قسمت می‌توانید Merchant جدید ایجاد کنید یا Merchant موجود را انتخاب کرده و Merchant ID را دریافت کنید. افزونه Merchant ID را با فرمت UUID دریافت می‌ کند.

در پنل Botble به مسیر زیر بروید:

Admin → Settings → Payment → Payment Methods → ZarinPal → Merchant ID

سپس Merchant ID را در فیلد مربوطه قرار داده و تنظیمات را ذخیره کنید.

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

قبل از نصب افزونه به چه چیزهایی نیاز دارید؟

برای استفاده از افزونه، سایت شما باید Botble CMS را به همراه ماژول Ecommerce داشته باشد.

همچنین به موارد زیر نیاز دارید:

• نصب سازگار Botble CMS و Ecommerce
• حساب فعال زرین‌پال
• Merchant ID معتبر

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

این افزونه برای چه سایت‌هایی مناسب است؟

این افزونه بیشتر برای توسعه‌ دهندگان و مدیرانی طراحی شده که از Botble CMS برای فروشگاه‌ های ایرانی استفاده می‌ کنند.

برای مثال، در شرایط زیر می‌ توانید از آن استفاده کنید:

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

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

دانلود افزونه ZarinPal Payment Gateway برای Botble CMS

افزونه ZarinPal Payment Gateway for Botble CMS محصول AryaPortal برای پروژه‌های Botble Ecommerce که به پرداخت زرین‌ پال نیاز دارند، توسعه داده شده است.

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

قبل از نصب، نسخه Botble و Ecommerce خود را بررسی کنید و مطمئن شوید یک حساب فعال زرین‌پال و Merchant ID معتبر دارید.

برای دانلود افزونه درگاه پرداخت زرین‌ پال برای Botble CMS می‌توانید به صفحه دانلود محصول در AryaPortal مراجعه کنید.

سوالات متداول

آیا افزونه از ZarinPal REST API v4 استفاده می‌ کند؟

بله. درخواست‌ های پرداخت و فرآیند تأیید تراکنش با استفاده از ZarinPal REST API v4 انجام می‌ شوند.

آیا امکان تست درگاه قبل از استفاده واقعی وجود دارد؟

بله. افزونه از دو حالت Sandbox و Live پشتیبانی می‌ کند و محیط مورد نظر از تنظیمات درگاه قابل انتخاب است.

آیا امکان انتخاب تومان و ریال وجود دارد؟

بله. می‌توانید واحد پرداخت را به‌صورت جداگانه برای درگاه روی IRT (تومان) یا IRR (ریال) تنظیم کنید.

آیا افزونه با Checkout استاندارد Botble Ecommerce کار می‌ کند؟

بله. افزونه برای استفاده با فرآیند پرداخت موجود در Botble Ecommerce طراحی شده و نیاز به ایجاد Checkout جداگانه ندارد.

Merchant ID را کجا وارد کنم؟

پس از فعال‌سازی افزونه به مسیر Admin → Settings → Payment → Payment Methods بروید، تنظیمات ZarinPal را باز کنید و Merchant ID خود را وارد نمایید.

آیا افزونه از زبان فارسی پشتیبانی می‌کند؟

بله. افزونه دارای پشتیبانی فارسی و انگلیسی برای رابط مدیریت و پیام‌ های مرتبط است.

جمع‌ بندی

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

ZarinPal Payment Gateway for Botble CMS با درنظرگرفتن همین نیازها توسعه داده شده است.

پشتیبانی از ZarinPal REST API v4، حالت Sandbox و Live، انتخاب مستقل IRT و IRR، اطلاعات تراکنش، پشتیبانی فارسی و انگلیسی و هماهنگی با Botble Ecommerce، این افزونه را به یک راهکار اختصاصی برای اضافه‌ کردن زرین‌پال به فروشگاه‌ های مبتنی بر Botble تبدیل می‌ کند.

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