اگر میخواهید در فروشگاه وردپرسی خود امکان پرداخت سفارش از طریق «بله» را فعال کنید، افزونه درگاه پرداخت بله برای ووکامرس میتواند فرآیند خرید را به ربات بله متصل کند. مشتری پس از انتخاب این روش پرداخت، به ربات فروشگاه منتقل میشود، فاکتور سفارش را در بله میبیند و پرداخت را همانجا انجام میدهد.
این اتصال بهصورت خودکار بین ووکامرس، ربات بله و سرویس پرداخت انجام میشود و پس از پرداخت نیز تراکنش از طریق API بررسی میشود تا سفارش تنها در صورت تأیید واقعی، پرداختشده ثبت شود.
افزونه درگاه پرداخت بله برای ووکامرس چگونه کار میکند؟
این افزونه یک ارتباط مستقیم میان فروشگاه اینترنتی و سرویس پرداخت بله ایجاد میکند. پس از ثبت سفارش، ووکامرس اطلاعات سفارش را در اختیار افزونه قرار میدهد و افزونه یک لینک اختصاصی برای ادامه فرآیند پرداخت ایجاد میکند.
کاربر با انتخاب گزینه «پرداخت با بله» به ربات فروشگاه منتقل میشود. ربات سفارش مربوط به همان کاربر را شناسایی کرده و فاکتور پرداخت را داخل محیط بله نمایش میدهد.
پس از پرداخت، نتیجه تراکنش دریافت شده و برای جلوگیری از تأیید اشتباه، اطلاعات پرداخت دوباره بررسی میشود. در این مرحله مبلغ سفارش، شناسه کاربر و وضعیت تراکنش با اطلاعات سفارش ووکامرس مقایسه میشوند.
به همین دلیل، تأیید سفارش صرفاً بر اساس پیام موفقیت پرداخت انجام نمیشود و نتیجه نهایی از سرویس بله نیز استعلام خواهد شد.
مهمترین امکانات افزونه پرداخت بله
این افزونه بخشهای مختلف فرآیند پرداخت را از زمان انتخاب درگاه تا تأیید نهایی سفارش مدیریت میکند.
برخی از قابلیتهای اصلی آن عبارتاند از:
- اتصال ووکامرس به API پرداخت بله
- نمایش گزینه پرداخت با بله در صفحه تسویهحساب
- انتقال خودکار مشتری به ربات بله
- شناسایی سفارش بدون نیاز به وارد کردن دستی شماره سفارش
- ارسال فاکتور پرداخت در ربات با متد
sendInvoice - پشتیبانی از Bot Token و Provider Token
- بررسی
PreCheckoutQueryپیش از تکمیل پرداخت - دریافت نتیجه پرداخت از طریق
SuccessfulPayment - استعلام مجدد تراکنش از سرور بله
- بررسی تطابق مبلغ پرداختی با مبلغ سفارش
- بررسی شناسه کاربر پیش از تأیید سفارش
- ثبت شناسه تراکنش و شماره پیگیری در سفارش ووکامرس
- ارسال پیام تأیید پرداخت برای مشتری
- ارائه لینک بازگشت به فروشگاه پس از پرداخت
- پشتیبانی از ریال و تومان
- ثبت خطاها و گزارشهای ارتباط با بله در Log ووکامرس
- سازگاری با سیستم HPOS ووکامرس
پشتیبانی از رباتهای بله با Webhook قبلی
یکی از نکات کاربردی این افزونه، امکان استفاده از رباتی است که از قبل برای کسبوکار شما فعال شده است.
اگر ربات بله شما پیش از این برای پشتیبانی مشتریان، نمایش منو، فروش محصولات یا امکانات اختصاصی دیگری استفاده میشده و Webhook مخصوص خود را دارد، لزوماً نیازی نیست یک ربات جدید فقط برای پرداخت بسازید.
افزونه میتواند بین بله و Webhook فعلی ربات قرار بگیرد و مانند یک Router، رویدادهای مرتبط با پرداخت ووکامرس را از سایر پیامها جدا کند.
در این حالت:
- رویدادهای مربوط به پرداخت توسط افزونه پردازش میشوند.
- پیامهای معمول کاربران به Webhook قبلی منتقل میشوند.
- منوها و Callbackهای موجود ربات میتوانند به فعالیت خود ادامه دهند.
- Webhook قبلی ذخیره میشود تا در صورت نیاز بتوان آن را دوباره فعال کرد.
این قابلیت برای فروشگاههایی که قبلاً یک ربات بله فعال دارند اهمیت زیادی دارد؛ زیرا اضافه کردن پرداخت آنلاین نباید باعث از کار افتادن قابلیتهای قبلی ربات شود.
سه روش مدیریت Webhook در افزونه
در تنظیمات افزونه میتوان نحوه مدیریت Webhook را متناسب با ساختار ربات انتخاب کرد.
۱. ربات اختصاصی پرداخت
این گزینه برای زمانی مناسب است که ربات موردنظر فقط برای پرداخت سفارشهای ووکامرس استفاده میشود و Webhook دیگری روی آن فعال نیست.
در این حالت ساختار سادهتر است و افزونه مدیریت Webhook پرداخت را بر عهده میگیرد.
۲. ربات دارای Webhook قبلی
اگر ربات شما از قبل یک برنامه یا سرویس فعال دارد، این حالت گزینه مناسبتری است.
افزونه Webhook فعلی را دریافت و ذخیره کرده و بین درخواستهای بله و سرویس قبلی نقش واسط را ایفا میکند.
۳. حالت دستی
در حالت دستی، افزونه Webhook ربات را تغییر نمیدهد.
این روش بیشتر برای مدیران سایت یا توسعهدهندگانی مناسب است که میخواهند پیکربندی Webhook را بهصورت مستقل مدیریت کنند.
آموزش نصب و راهاندازی درگاه بله در ووکامرس
بعد از نصب و فعالسازی افزونه، برای دسترسی به تنظیمات درگاه به مسیر زیر بروید:
ووکامرس ← پیکربندی ← پرداختها ← پرداخت با بله
برای فعالسازی درگاه، چند اطلاعات اصلی باید در تنظیمات افزونه وارد شود.
Bot Token چیست؟
Bot Token شناسهای است که هنگام ایجاد ربات یا بازوی بله دریافت میکنید.
این توکن به افزونه اجازه میدهد با ربات ارتباط برقرار کند و عملیات موردنیاز برای شناسایی کاربران و سفارشها را انجام دهد.
پس از وارد کردن Bot Token، افزونه میتواند اعتبار توکن را بررسی کرده و در صورت صحیح بودن اطلاعات، نام کاربری ربات را دریافت کند.
Provider Token چیست؟
Provider Token مربوط به سرویس پرداخت بله است و برای ایجاد فاکتور و پردازش پرداخت مورد استفاده قرار میگیرد.
بنابراین برای راهاندازی کامل درگاه، صرفاً داشتن توکن ربات کافی نیست و باید اطلاعات مربوط به سرویس پرداخت نیز در تنظیمات وارد شود.
انتخاب واحد پول؛ تومان یا ریال؟
یکی از تنظیمات مهم هنگام راهاندازی درگاه، مشخص کردن واحد پول فروشگاه است.
اگر قیمت محصولات در ووکامرس به تومان ثبت شدهاند، گزینه تومان را انتخاب کنید. افزونه مبلغ را هنگام ارسال به سرویس پرداخت به واحد موردنیاز تبدیل میکند.
برای مثال، اگر قیمت یک محصول در فروشگاه:
250,000 تومان
باشد، مبلغ ارسالشده برای پرداخت باید معادل ریالی آن باشد.
در مقابل، اگر قیمت محصولات شما از ابتدا بر اساس ریال ثبت شدهاند، باید گزینه ریال را انتخاب کنید.
انتخاب اشتباه واحد پول میتواند باعث ایجاد اختلاف بین مبلغ نمایش دادهشده در فروشگاه و مبلغ فاکتور پرداخت شود؛ بنابراین این بخش را هنگام نصب با دقت تنظیم کنید.
فرآیند پرداخت مشتری در بله
بعد از فعال کردن درگاه، مشتری در صفحه تسویهحساب ووکامرس گزینه «پرداخت با بله» را مشاهده خواهد کرد.
فرآیند خرید به شکل زیر انجام میشود:
- مشتری محصولات را به سبد خرید اضافه میکند.
- در صفحه تسویهحساب، روش «پرداخت با بله» را انتخاب میکند.
- سفارش در ووکامرس ایجاد میشود.
- افزونه برای همان سفارش یک شناسه و لینک اختصاصی ایجاد میکند.
- مشتری به ربات بله فروشگاه منتقل میشود.
- ربات سفارش مربوط به کاربر را شناسایی میکند.
- فاکتور سفارش در محیط بله نمایش داده میشود.
- مشتری مبلغ فاکتور را پرداخت میکند.
- اطلاعات تراکنش توسط افزونه دریافت میشود.
- وضعیت پرداخت از سرویس بله استعلام میشود.
- مبلغ و اطلاعات تراکنش با سفارش ووکامرس تطبیق داده میشود.
- در صورت تأیید، وضعیت سفارش به شکل خودکار تغییر میکند.
- لینک بازگشت به فروشگاه برای مشتری ارسال میشود.
در این فرآیند، کاربر مجبور نیست شماره سفارش یا کد پرداخت را بهصورت دستی وارد کند. ارتباط میان سفارش ووکامرس و کاربر ربات از طریق اطلاعات اختصاصی همان تراکنش انجام میشود.
چرا استعلام مجدد تراکنش اهمیت دارد؟
در یک سیستم پرداخت، نمایش پیام «پرداخت موفق» بهتنهایی نباید معیار نهایی تأیید سفارش باشد.
برای مثال، تصور کنید سفارش شما 800 هزار تومان است اما اطلاعات تراکنش دریافتی با مبلغ سفارش مطابقت ندارد. در چنین شرایطی نباید سفارش بهصورت خودکار پرداختشده ثبت شود.
افزونه با بررسی اطلاعات تراکنش و استعلام مجدد وضعیت پرداخت از بله، یک لایه کنترل اضافی ایجاد میکند.
مهمترین مواردی که باید با سفارش تطبیق داده شوند عبارتاند از:
- مبلغ سفارش
- شناسه کاربر
- وضعیت تراکنش
- شناسه پرداخت
- اطلاعات مربوط به سفارش
این کنترلها احتمال ثبت تراکنش نامعتبر یا پرداخت با مبلغ اشتباه را کاهش میدهند.
امنیت پرداخت در افزونه بله ووکامرس
امنیت درگاه فقط به انتقال کاربر به صفحه پرداخت محدود نمیشود. مهمترین بخش، نحوه اعتبارسنجی نتیجه تراکنش پس از پرداخت است.
در این افزونه، اطلاعات مربوط به لینک سفارش و فاکتور با مکانیزمهای امنیتی کنترل میشوند و قبل از تغییر وضعیت سفارش، اطلاعات دریافتی مورد بررسی قرار میگیرد.
بهعنوان نمونه، اگر مبلغ تراکنش با مبلغ ثبتشده در سفارش یکسان نباشد، نباید سفارش بهعنوان پرداخت موفق ثبت شود.
همچنین پس از دریافت نتیجه موفقیت پرداخت، وضعیت تراکنش دوباره از سرور بله بررسی میشود.
این روش باعث میشود سیستم فروشگاه صرفاً به یک پاسخ دریافتی از سمت کاربر یا ربات اعتماد نکند و تأیید نهایی را بر اساس وضعیت واقعی تراکنش انجام دهد.
ثبت اطلاعات تراکنش در ووکامرس
بعد از پرداخت موفق، اطلاعات مرتبط با تراکنش در سفارش ووکامرس ثبت میشود.
ثبت این اطلاعات برای مدیریت فروشگاه اهمیت زیادی دارد؛ زیرا مدیر سایت میتواند هنگام بررسی سفارش، اطلاعات پرداخت را نیز در کنار جزئیات خرید مشاهده کند.
این اطلاعات میتوانند برای مواردی مانند:
- بررسی سفارشهای پرداختشده
- پیگیری تراکنش
- پاسخگویی به مشتری
- بررسی خطاهای احتمالی
- عیبیابی پرداخت
- تطبیق تراکنشها
مورد استفاده قرار گیرند.
بررسی خطاها از طریق Log ووکامرس
در فروشگاههای اینترنتی، فقط موفقیت پرداخت اهمیت ندارد؛ بلکه باید بتوان خطاهای احتمالی را نیز بررسی کرد.
افزونه گزارشهای مربوط به ارتباط با سرویس بله و خطاهای رخداده را در Log ووکامرس ثبت میکند.
این قابلیت به مدیر سایت یا توسعهدهنده کمک میکند هنگام بروز مشکل، به جای بررسی حدسی تنظیمات، اطلاعات فنی مرتبط با درخواستها و پاسخهای سیستم را بررسی کند.
اگر درگاه کار نمیکند، یکی از اولین بخشهایی که باید بررسی شود Log ووکامرس است.
سازگاری با HPOS ووکامرس
HPOS یا High-Performance Order Storage یکی از تغییرات مهم در معماری ذخیره سفارشهای ووکامرس است.
افزونه پرداخت بله از HPOS پشتیبانی میکند؛ بنابراین در فروشگاههایی که از ساختار جدید ذخیرهسازی سفارشهای ووکامرس استفاده میکنند نیز میتوان از این درگاه استفاده کرد.
این موضوع برای فروشگاههای وردپرسی جدید اهمیت بیشتری دارد؛ زیرا بهتر است افزونههای پرداخت مورد استفاده، با معماریهای جدید ووکامرس سازگار باشند.
یک مثال کاربردی برای فروشگاه اینترنتی
فرض کنید یک فروشگاه آنلاین پوشاک با ووکامرس دارید و مشتری یک محصول 1,200,000 تومانی خریداری میکند.
مشتری در صفحه پرداخت، گزینه «پرداخت با بله» را انتخاب میکند. سفارش در ووکامرس ایجاد شده و یک لینک اختصاصی برای ادامه پرداخت در اختیار مشتری قرار میگیرد.
کاربر وارد ربات بله میشود و فاکتور مربوط به همان سفارش را مشاهده میکند. پس از پرداخت، افزونه نتیجه تراکنش را دریافت کرده و مبلغ پرداختی را با مبلغ سفارش مقایسه میکند.
اگر تراکنش معتبر باشد، سفارش بدون دخالت مدیر سایت تأیید میشود.
این فرآیند میتواند تعداد مراحل دستی در پرداخت را کاهش دهد و تجربه خرید سادهتری برای مشتریانی ایجاد کند که از بله استفاده میکنند.
این درگاه برای چه فروشگاههایی مناسب است؟
افزونه پرداخت بله میتواند برای انواع فروشگاههای وردپرسی مبتنی بر ووکامرس کاربرد داشته باشد؛ بهخصوص فروشگاههایی که بخشی از مشتریان آنها از پیامرسان بله استفاده میکنند.
برای نمونه:
- فروشگاههای پوشاک
- فروشگاههای محصولات دیجیتال
- فروشگاههای لوازم جانبی
- فروشگاههای آموزشی
- فروشگاههای خدمات آنلاین
- فروشگاههای محصولات فرهنگی
- فروشگاههای کوچک و متوسط مبتنی بر وردپرس
اگر کسبوکار شما در کنار سایت، یک ربات بله فعال دارد، قابلیت پشتیبانی از Webhook قبلی میتواند مزیت مهمی باشد؛ زیرا امکان اضافه کردن پرداخت بدون ایجاد اختلال در ساختار فعلی ربات فراهم میشود.
نکات مهم قبل از نصب افزونه
قبل از فعالسازی درگاه، بهتر است چند مورد را بررسی کنید:
- ربات بله را بهدرستی ایجاد و فعال کرده باشید.
- Bot Token معتبر در اختیار داشته باشید.
- Provider Token مربوط به پرداخت را دریافت کرده باشید.
- واحد پول ووکامرس را بررسی کرده باشید.
- در صورت داشتن Webhook قبلی، نوع اتصال مناسب را انتخاب کنید.
- یک سفارش آزمایشی برای بررسی فرآیند پرداخت انجام دهید.
- Log ووکامرس را بعد از تست بررسی کنید.
- پس از راهاندازی، تطابق مبلغ سفارش و فاکتور بله را آزمایش کنید.
انجام یک پرداخت آزمایشی قبل از قرار دادن درگاه در اختیار مشتریان، میتواند بسیاری از مشکلات مربوط به تنظیمات ربات، واحد پول یا Webhook را زودتر مشخص کند.
دانلود رایگان افزونه درگاه پرداخت بله برای ووکامرس
این افزونه بهصورت رایگان ارائه شده و برای نصب آن کافی است فایل ZIP افزونه را دریافت کنید.
در پیشخوان وردپرس به مسیر زیر بروید:
افزونهها ← افزودن افزونه ← بارگذاری افزونه
سپس فایل ZIP را انتخاب کرده و افزونه را نصب و فعال کنید.
بعد از فعالسازی، تنظیمات درگاه از مسیر تنظیمات پرداخت ووکامرس در دسترس خواهد بود.
نکته: پیش از استفاده در سایت اصلی، توصیه میشود افزونه را ابتدا روی محیط آزمایشی یا با یک سفارش کممبلغ بررسی کنید تا عملکرد ربات، Webhook و تأیید تراکنش مطابق نیاز فروشگاه شما باشد.
توسعهدهنده افزونه پرداخت بله
این افزونه توسط حامد فرهآبادی توسعه داده شده است. برای مشاهده اطلاعات و سوابق حرفهای توسعهدهنده میتوانید پروفایل او در لینکدین را مشاهده کنید: پروفایل حامد فرهآبادی در LinkedIn
در صورت استفاده از این افزونه در یک پروژه تجاری، بهتر است پیش از نصب، سازگاری نسخه افزونه با نسخه فعلی وردپرس، ووکامرس و سایر افزونههای سایت را بررسی کنید.
جمعبندی
افزونه درگاه پرداخت بله برای ووکامرس، امکان اتصال فروشگاه اینترنتی وردپرسی به ربات و سرویس پرداخت بله را فراهم میکند. مهمترین مزیت آن این است که مشتری میتواند پس از انتخاب درگاه، فاکتور سفارش را مستقیماً در محیط بله دریافت و پرداخت کند و نتیجه تراکنش نیز بهصورت خودکار به ووکامرس بازگردد.
پشتیبانی از Webhook قبلی، بررسی مجدد تراکنش، تطبیق مبلغ پرداختی با سفارش، ثبت اطلاعات تراکنش، پشتیبانی از تومان و ریال و سازگاری با HPOS باعث میشوند این افزونه فراتر از یک اتصال ساده میان ووکامرس و ربات عمل کند.
برای فروشگاههایی که مشتریان آنها از بله استفاده میکنند، اضافه کردن یک روش پرداخت اختصاصی میتواند مسیر خرید را کوتاهتر کرده و نیاز به انتقال دستی اطلاعات سفارش را کاهش دهد.
سوالات متداول
آیا افزونه پرداخت بله با ووکامرس کار میکند؟
بله. این افزونه برای اتصال سرویس پرداخت بله به فروشگاههای مبتنی بر ووکامرس طراحی شده و فرآیند ایجاد سفارش، ارسال فاکتور و تأیید پرداخت را مدیریت میکند.
آیا برای استفاده از افزونه باید ربات جدید بله بسازم؟
خیر. اگر ربات بله فعلی شما Webhook فعال داشته باشد، افزونه میتواند در حالت سازگار با Webhook قبلی مورد استفاده قرار گیرد. در صورتی که ربات فقط برای پرداخت استفاده میشود، میتوانید از حالت ربات اختصاصی پرداخت استفاده کنید.
آیا امکان استفاده از تومان وجود دارد؟
بله. افزونه از تومان و ریال پشتیبانی میکند. اگر قیمتهای ووکامرس بر اساس تومان هستند، باید واحد پول را در تنظیمات افزونه روی تومان قرار دهید تا مبلغ هنگام ارسال برای پرداخت به شکل صحیح تبدیل شود.
آیا افزونه بعد از پرداخت، تراکنش را دوباره بررسی میکند؟
بله. نتیجه پرداخت صرفاً بر اساس پیام موفقیت دریافتی تأیید نمیشود و وضعیت تراکنش از سرویس بله نیز استعلام میشود.
آیا مبلغ تراکنش با مبلغ سفارش ووکامرس تطبیق داده میشود؟
بله. مبلغ پرداختی با مبلغ سفارش مقایسه میشود تا از تأیید تراکنش با مبلغ اشتباه جلوگیری شود.
آیا اطلاعات تراکنش در ووکامرس ذخیره میشود؟
بله. اطلاعات مربوط به پرداخت، از جمله شناسه تراکنش و شماره پیگیری، در اطلاعات سفارش ثبت میشود تا امکان بررسی و پیگیری بعدی وجود داشته باشد.
آیا افزونه با HPOS ووکامرس سازگار است؟
بله. افزونه از HPOS ووکامرس پشتیبانی میکند و برای فروشگاههایی که از سیستم جدید ذخیرهسازی سفارشها استفاده میکنند قابل استفاده است.
اگر ربات بله من Webhook داشته باشد چه اتفاقی میافتد؟
در حالت سازگار، افزونه Webhook قبلی را ذخیره کرده و نقش واسط را بین بله و Webhook اصلی ایفا میکند. رویدادهای پرداخت توسط افزونه پردازش شده و سایر پیامها میتوانند به Webhook قبلی منتقل شوند.
اگر پرداخت ناموفق باشد، سفارش چه میشود؟
در صورت معتبر نبودن یا ناموفق بودن تراکنش، سفارش نباید بهعنوان پرداخت موفق تأیید شود. نتیجه نهایی بر اساس وضعیت تراکنش و بررسی اطلاعات پرداخت تعیین میشود.
آیا استفاده از این افزونه برای هر فروشگاه ووکامرسی مناسب است؟
اگر مشتریان فروشگاه شما از بله استفاده میکنند و قصد دارید پرداخت از طریق این پیامرسان را به سایت اضافه کنید، این افزونه میتواند گزینه مناسبی باشد. با این حال، بهتر است قبل از استفاده در سایت اصلی، سازگاری آن با نسخه وردپرس، ووکامرس، ربات و سایر افزونههای نصبشده را آزمایش کنید.
