وقتی تصمیم میگیرید یک سایت فروشگاهی یا خدماتی راهاندازی کنید، یکی از اولین دغدغهها این است که مشتری چگونه هزینه خرید خود را پرداخت کند. اتصال نادرست یا پیچیده درگاه پرداخت میتواند باعث از دست رفتن سفارشها و تجربه نامناسب کاربران شود.
در این مقاله آموزشگاه کندو یاد میگیرید اتصال درگاه پرداخت چگونه انجام میشود، چه اطلاعاتی برای راهاندازی آن نیاز دارید و در سایتهای وردپرسی، ووکامرس و سایتهای اختصاصی چه مراحلی باید طی شود. همچنین با خطاهای رایج این فرایند آشنا میشوید تا بتوانید پرداخت آنلاین را بدون مشکل در سایت خود فعال کنید.
درگاه پرداخت اینترنتی چیست؟
وقتی سایت شما آماده فروش محصول یا ارائه خدمات میشود، یکی از اولین چالشها ایجاد یک مسیر امن برای دریافت هزینه از مشتری است. درگاه پرداخت این مشکل را حل میکند و امکان پرداخت آنلاین را بدون نیاز به فرایندهای دستی فراهم میسازد.
درگاه پرداخت بین سایت و شبکه بانکی ارتباط برقرار میکند تا اطلاعات تراکنش بررسی شود و نتیجه پرداخت به سایت بازگردد. برای استفاده از آن، باید سرویس پرداخت را متناسب با ساختار سایت خود متصل کنید، این کار در وردپرس معمولاً با افزونه و در سایتهای اختصاصی با کدنویسی انجام میشود.
آشنایی با درگاه پرداخت و انواع آن
برای اتصال سایت به درگاه پرداخت، ابتدا باید نوع سرویس پرداخت موردنیاز خود را مشخص کنید. به طور کلی، درگاههای پرداخت در دو دسته اصلی قرار میگیرند:
- درگاه پرداخت مستقیم: در این روش، سایت به صورت مستقیم از یک بانک یا ارائهدهنده خدمات پرداخت مجوز دریافت میکند و تراکنشها از همان مسیر انجام میشوند.
- درگاه پرداخت واسط: در این مدل، یک شرکت پرداختیار بین سایت و شبکه بانکی قرار میگیرد و امکاناتی مانند راهاندازی سادهتر و مدیریت پرداختها را ارائه میدهد.
انتخاب نوع درگاه به شرایط کسبوکار، ساختار سایت و نیازهای فنی شما بستگی دارد. پس از انتخاب سرویس مناسب، مرحله بعدی اتصال درگاه پرداخت به سایت و تنظیم آن برای انجام تراکنشهای واقعی است.
درگاه پرداخت مستقیم چیست؟
درگاه پرداخت مستقیم روشی است که در آن سایت بدون واسطه به شبکه پرداخت یک بانک یا شرکت ارائهدهنده خدمات پرداخت متصل میشود. برای دریافت این نوع درگاه، کسبوکار باید مراحل ثبت درخواست، احراز هویت و دریافت اطلاعات دسترسی را طی کند.
در اتصال به درگاه پرداخت مستقیم، سایت باید بتواند از طریق API با سرویس پرداخت ارتباط برقرار کند، اطلاعات تراکنش را ارسال کند و نتیجه پرداخت را پس از بازگشت کاربر بررسی کند.
این نوع درگاه معمولاً برای کسبوکارهایی مناسب است که تراکنشهای بیشتری دارند و به مدیریت مستقیم فرآیند پرداخت نیاز دارند. در سایتهای وردپرسی این اتصال معمولاً با افزونههای مخصوص انجام میشود و در سایتهای اختصاصی نیاز به پیادهسازی فنی دارد.
درگاه پرداخت واسط چیست؟
درگاه پرداخت واسط، سرویسی است که شرکتهای پرداختیار بین سایت و شبکه بانکی قرار میدهند تا فرایند دریافت درگاه برای کسبوکارها سادهتر شود. در این روش، سایت به جای اتصال مستقیم به بانک، از زیرساخت شرکت واسط برای انجام تراکنشها استفاده میکند.
این نوع درگاه معمولاً برای شروع فعالیت آنلاین گزینه مناسبی است، زیرا راهاندازی آن نسبت به درگاه مستقیم سادهتر است و امکاناتی مانند مدیریت تراکنشها و گزارشگیری را در اختیار صاحب سایت قرار میدهد.
برای استفاده از این درگاه، پس از دریافت دسترسیهای لازم، میتوان از طریق افزونههای آماده یا API آن را به سایت متصل کرد.

پیشنیازهای قانونی دریافت درگاه پرداخت
قبل از اقدام برای دریافت درگاه پرداخت (چه مستقیم و چه واسط)، داشتن دو مورد زیر طبق قوانین بانکی کشور الزامی است:
- کد مالیاتی: تمام پذیرندگان درگاههای پرداخت باید در سامانه امور مالیاتی ثبتنام کرده و پرونده فعال داشته باشند.
- نماد اعتماد الکترونیکی (اینماد): داشتن اینماد برای احراز هویت کسبوکار و صدور درگاه توسط پرداختیارها و شرکتهای PSP ضروری است.
بدون تکمیل این دو مرحله، امکان دریافت اطلاعات اتصال (مانند مرچنت کد) از ارائهدهندگان درگاه وجود نخواهد داشت.
مراحل اتصال درگاه پرداخت به وبسایت
بربرای راهاندازی پرداخت آنلاین، فقط نصب یک افزونه یا قرار دادن چند خط کد کافی نیست. در آموزش اتصال به درگاه پرداخت، چند مرحله مشخص وجود دارد که باید به ترتیب انجام شوند تا ارتباط سایت با سرویس پرداخت بهدرستی برقرار شود.
دریافت رابط اینترنتی پرداخت
اولین مرحله، دریافت دسترسی اتصال از سرویسدهنده درگاه است. در این مرحله اطلاعاتی مانند شناسه پذیرنده، کلیدهای دسترسی یا تنظیمات مورد نیاز برای ارتباط سایت با درگاه دریافت میشود.
نصب افزونه یا کد درگاه
روش اتصال به ساختار سایت بستگی دارد. در سایتهای وردپرسی معمولاً از افزونه اتصال درگاه پرداخت استفاده میشود. در سایتهای اختصاصی، برنامهنویس باید ارتباط سایت با سرویس پرداخت را با کدنویسی و API پیادهسازی کند.
پیکربندی درگاه پرداخت اینترنتی
پس از نصب، تنظیمات درگاه باید در سایت انجام شود. مواردی مانند اطلاعات اتصال، واحد پول، روش نمایش پرداخت و تنظیم مسیر بازگشت پس از تراکنش در این مرحله مشخص میشوند. در این بخش، طراحی مسیر پرداخت ساده و قابل فهم برای کاربر اهمیت زیادی دارد، زیرا تجربه کاربری مناسب میتواند از سردرگمی هنگام خرید جلوگیری کند. آشنایی با مباحثی مانند ui ux دوره به درک بهتر اصول طراحی این مسیرها کمک میکند.
تست درگاه پرداخت
قبل از فعالسازی نهایی، باید چند تراکنش آزمایشی انجام شود تا عملکرد صحیح اتصال بررسی شود. خطاهای مربوط به پرداخت ناموفق، بازگشت کاربر و ثبت سفارش در این مرحله شناسایی و رفع میشوند.
بعد از دریافت درگاه پرداخت چه اطلاعاتی به شما داده میشود؟
بعد از تأیید درخواست درگاه، برای اتصال سایت به سرویس پرداخت یکسری اطلاعات فنی در اختیار شما قرار میگیرد. این اطلاعات مانند کلید ارتباطی بین سایت و درگاه عمل میکنند و باید بهدرستی در افزونه یا کد سایت تنظیم شوند.
مرچنت کد یا API Key
مرچنت کد یا API Key یک شناسه اختصاصی است که سرویس پرداخت برای شناسایی سایت شما ارائه میکند. این مقدار هنگام ارسال درخواست پرداخت استفاده میشود و بدون آن، سایت نمیتواند با درگاه ارتباط برقرار کند.
شماره ترمینال و رمز عبور در درگاههای مستقیم
در برخی درگاههای مستقیم بانکی، اطلاعاتی مانند شماره ترمینال، نام کاربری و رمز عبور برای احراز هویت اتصال ارائه میشود. این اطلاعات باید در تنظیمات درگاه وارد شوند و نباید در اختیار افراد غیرمجاز قرار بگیرند.
ثبت دامنه سایت
دامنه سایت باید در سامانه درگاه ثبت شود تا سرویس پرداخت بداند درخواستها از چه وبسایتی ارسال میشوند. ثبت اشتباه دامنه میتواند باعث خطا هنگام انجام تراکنش شود.
ثبت IP سرور و اهمیت آن در عملکرد درگاه
برخی سرویسهای پرداخت برای افزایش امنیت، IP سرور سایت را ثبت میکنند تا فقط درخواستهای معتبر از همان سرور پذیرفته شوند. تغییر سرور یا هاست بدون بهروزرسانی IP ثبتشده ممکن است باعث اختلال در عملکرد درگاه شود.

نحوه اتصال درگاه پرداخت به سایت وردپرس
روش اتصال درگاه پرداخت به وردپرس به ساختار سایت شما بستگی دارد. اگر از فروشگاهساز استفاده میکنید، معمولاً مسیر اتصال سادهتر است، اما در سایتهای اختصاصی وردپرسی یا پروژههای توسعهیافته، ممکن است به تنظیمات فنی بیشتری نیاز داشته باشید.
اتصال درگاه پرداخت به ووکامرس
نحوه اتصال درگاه پرداخت به ووکامرس معمولاً از طریق افزونههای آماده انجام میشود. این افزونهها امکان ارتباط بین فروشگاه ووکامرسی و سرویس پرداخت را فراهم میکنند و بدون نیاز به کدنویسی مستقیم، مراحل دریافت اطلاعات درگاه، تنظیمات پرداخت و انجام تراکنش را سادهتر میکنند. پس از نصب افزونه و وارد کردن اطلاعات اتصال، باید عملکرد درگاه را با یک پرداخت آزمایشی بررسی کنید.
اگر سایت وردپرسی دارید ولی ووکامرس استفاده نمیکنید
در سایتهای اختصاصی که با PHP یا زبانهای برنامهنویسی دیگر توسعه داده شدهاند، اتصال درگاه پرداخت معمولاً از طریق API انجام میشود. در این روش، توسعهدهنده باید درخواست پرداخت را با استفاده از مستندات سرویسدهنده ارسال کند، کاربر را به صفحه پرداخت هدایت کند و پس از بازگشت، نتیجه تراکنش را بررسی کند.
در اتصال درگاه پرداخت به سایت PHP، هماهنگی صحیح بین کدهای سایت، اطلاعات احراز هویت و مسیر بازگشت پرداخت اهمیت زیادی دارد؛ زیرا کوچکترین خطا در پیادهسازی میتواند باعث ثبت نشدن تراکنش یا ایجاد خطا برای کاربر شود.
اگر سایت شما وردپرسی یا ووکامرسی نیست
در سایتهای اختصاصی، اتصال درگاه معمولاً با استفاده از API انجام میشود. توسعهدهنده باید درخواست پرداخت را به سرویس درگاه ارسال کند، کاربر را به صفحه پرداخت هدایت کند و نتیجه تراکنش را پس از بازگشت بررسی کند.
برای یادگیری ساختار کامل سایت، از طراحی صفحات تا پیادهسازی قابلیتهای کاربردی، آشنایی با مسیرهایی مانند دورههای برنامه نویسی میتواند دید بهتری از مراحل توسعه وب ایجاد کند.
اتصال درگاه پرداخت در ووکامرس
اگر سایت شما با وردپرس و ووکامرس ساخته شده است، سادهترین روش اتصال درگاه پرداخت استفاده از افزونههای آماده است. این افزونهها ارتباط بین ووکامرس و سرویس پرداخت را برقرار میکنند و نیاز به کدنویسی مستقیم را کاهش میدهند.
۱- دانلود افزونه درگاه پرداخت
ابتدا باید افزونه مناسب درگاه موردنظر خود را از منبع معتبر دریافت کنید. هنگام انتخاب افزونه، سازگاری آن با نسخه وردپرس، ووکامرس و پشتیبانی از سرویس پرداخت اهمیت دارد.
۲- نصب افزونه درگاه پرداخت
پس از دانلود افزونه، از بخش مدیریت وردپرس وارد مسیر افزونهها > افزودن شوید و فایل افزونه را نصب و فعال کنید. بعد از فعالسازی، گزینه تنظیمات درگاه به بخش ووکامرس اضافه میشود.
۳- تنظیمات افزونه درگاه پرداخت
در این مرحله باید اطلاعات دریافتشده از سرویس پرداخت مانند مرچنت کد یا کلید API را در تنظیمات افزونه وارد کنید. همچنین مشخص میکنید پرداخت چگونه در صفحه تسویهحساب نمایش داده شود.
۴- تست و بررسی عملکرد درگاه پرداخت
قبل از فعال کردن پرداخت برای مشتریان، یک خرید آزمایشی انجام دهید. بررسی کنید که کاربر به صفحه پرداخت منتقل میشود، پس از پرداخت به سایت بازمیگردد و سفارش در ووکامرس بهدرستی ثبت میشود.
۵- نکات مهم در استفاده از درگاه پرداخت
برای جلوگیری از خطاهای پرداخت، چند مورد را همیشه بررسی کنید:
- افزونه درگاه را بهروز نگه دارید.
- اطلاعات اتصال درگاه را در اختیار افراد غیرمجاز قرار ندهید.
- پس از تغییر هاست یا دامنه، تنظیمات درگاه را بررسی کنید.
- خطاهای تراکنش و گزارشهای پرداخت را به صورت دورهای بررسی کنید.
مدیریت صحیح ووکامرس و افزونهها بخش مهمی از ساخت فروشگاه اینترنتی است و آشنایی با این مسیر در کنار یادگیری مهارتهای تکمیلی مانند دوره وردپرس، درک بهتری از توسعه سایتهای فروشگاهی ایجاد میکند.

مشکلات و خطاهای رایج در راهاندازی درگاه پرداخت
بخش زیادی از خطاهای پرداخت، به مشکل در خود درگاه مربوط نیست، بلکه از تنظیمات اشتباه سایت یا اطلاعات نادرست اتصال ایجاد میشود. شناخت این خطاها کمک میکند سریعتر مشکل را پیدا و رفع کنید.
اشتباه در IP سرور
اگر IP سرور سایت با اطلاعات ثبتشده در درگاه مطابقت نداشته باشد، درخواستهای پرداخت ممکن است رد شوند. این مشکل معمولاً بعد از تغییر هاست یا انتقال سایت رخ میدهد.
برای آشنایی بیشتر با مفهوم IP خواندن مقالهی «آدرس آی پی ip چیست؟» را پیشنهاد میکنیم.
عدم تطابق دامنه
درگاه پرداخت برای امنیت، دامنه ثبتشده را بررسی میکند. اگر دامنه سایت تغییر کرده باشد یا آدرس اشتباهی در تنظیمات درگاه ثبت شده باشد، فرآیند پرداخت با خطا مواجه میشود.
تنظیمات نادرست افزونه
در سایتهای وردپرسی، وارد کردن اشتباه اطلاعاتی مانند مرچنت کد، فعال نبودن افزونه یا ناسازگاری نسخه افزونه با ووکامرس میتواند باعث اختلال در پرداخت شود.
خطاهای بازگشت از بانک
گاهی کاربر پرداخت را انجام میدهد اما نتیجه تراکنش به سایت بازنمیگردد. تنظیم نادرست آدرس بازگشت (Callback URL)، مشکلات هاست یا خطا در ارتباط افزونه با درگاه از دلایل رایج این مشکل هستند.
نقش پشتیبانی درگاههای پرداخت
در برخی خطاها، بررسی تنظیمات سایت کافی نیست و نیاز به پیگیری از سرویسدهنده پرداخت وجود دارد. داشتن پشتیبانی مناسب کمک میکند مشکلات مربوط به وضعیت تراکنش، دسترسیها یا اختلال سرویس سریعتر بررسی شوند.

معرفی بهترین درگاه پرداخت اینترنتی
درگاههای زیر بر اساس سه شاخص کلیدی سرعت فعالسازی، پایداری تراکنشها و سهولت اتصال به سایت انتخاب شدهاند و از کاربردیترین گزینهها برای کسبوکارهای ایرانی به شمار میروند:
درگاههای پرداخت واسط (پرداختیارها – راهاندازی سریع و آسان):
- زرینپال (ZarinPal): باسابقتترین پرداختیار ایران با افزونههای آماده برای انواع CMS و پشتیبانی قوی از ووکامرس.
- زیبال (Zibal): دارای زیرساخت مسیردهی هوشمند تراکنشها برای کاهش قطعی و افزایش نرخ موفقیت پرداخت.
- پیپینگ (PayPing): گزینهای ایدهآل برای مدیریت فاکتورهای آنلاین، گزارشگیری دقیق و تسویهحساب منظم.
درگاههای پرداخت مستقیم (شرکتهای PSP – ویژه کسبوکارهای رسمی و پرتراکنش):
- بهپرداخت ملت: باثباتترین و محبوبترین درگاه مستقیم بانکی با بیشترین سهم تراکنش در کشور.
- پرداخت الکترونیک سامان (سپ): سرعت بالا در پردازش و زیرساخت بسیار قوی برای فروشگاههای پرترافیک.
- تجارت الکترونیک پارسیان (پککو): یکی از قدیمیترین و امنترین شبکههای پرداخت بانکی با پایداری عالی.
جمعبندی
اتصال درگاه پرداخت به سایت شامل چند مرحله از دریافت اطلاعات درگاه تا نصب، تنظیمات و تست نهایی است. توجه به جزئیاتی مانند تنظیمات افزونه، اطلاعات اتصال و خطاهای احتمالی، باعث میشود پرداخت آنلاین بدون مشکل انجام شود.
یادگیری این مهارت در کنار مباحث طراحی و توسعه سایت، شما را برای اجرای پروژههای واقعی وب آمادهتر میکند.
سوالات متداول
آیا برای فعالسازی درگاه پرداخت به نماد اعتماد نیاز است؟
بسته به نوع سرویس پرداخت و قوانین ارائهدهنده درگاه، ممکن است به مجوزهای مشخصی نیاز داشته باشید.
چرا مبلغ پرداختشده توسط مشتری با تأخیر به حساب واریز میشود؟
زمان تسویه به قوانین سرویس پرداخت و چرخههای بانکی بستگی دارد.
آیا میتوان چند درگاه پرداخت را همزمان روی یک سایت فعال کرد؟
بله، در بسیاری از سایتها برای کاهش خطا یا ارائه گزینههای بیشتر، چند درگاه فعال میشود.
چرا درگاه پرداخت در موبایل بهتر است تست شود؟
زیرا بخش زیادی از خریدهای آنلاین با موبایل انجام میشود و مشکلات نمایش یا بازگشت از پرداخت ممکن است فقط در این دستگاه دیده شود.
