درگاه پرداخت اینترنتی برای سایت؛ مستقیم یا واسط، اتصال و تست پرداخت

درگاه پرداخت اینترنتی برای سایت؛ مستقیم یا واسط، اتصال و تست پرداخت
AI
خلاصه مطلبراهنمای سریع مطالعه و ساختار قابل خواندن برای هوش مصنوعی

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

اندازه متن22px

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

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

مراحل اتصال درگاه پرداخت به سایت از درخواست تراکنش تا تأیید نهایی

درگاه پرداخت اینترنتی برای سایت چه کاری انجام می‌دهد؟

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

مسیر استاندارد خرید آنلاین:

محصول ← سبد خرید ← ثبت سفارش ← درخواست پرداخت ← صفحه پرداخت ← Callback ← Verify ← نهایی‌سازی سفارش و صدور رسید

نکته مهم این است که بازگشت مشتری به سایت یا مشاهده پیام «پرداخت موفق» در مرورگر، به‌تنهایی اثبات قطعی پرداخت نیست. تأیید نهایی باید از سمت سرور و از طریق API ارائه‌دهنده انجام شود.

درگاه مستقیم بانکی یا درگاه پرداخت‌یار؟

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

۱. درگاه مستقیم بانکی

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

۲. درگاه پرداخت‌یار یا واسط

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

معیار مقایسهدرگاه مستقیمپرداخت‌یار
رابطه پذیرندگیمستقیم‌تر با PSPاز طریق پرداخت‌یار
فرآیند دریافتمطابق شرایط PSPمطابق شرایط پرداخت‌یار
مستندات فنیمستندات اختصاصی ارائه‌دهندهAPI و مستندات پرداخت‌یار
هزینه و تسویهوابسته به قراردادوابسته به تعرفه و قرارداد
مناسب برایکسب‌وکارهای واجد شرایط پذیرندگی مستقیمکسب‌وکارهای متقاضی خدمات پرداخت‌یار

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

پیش از انتخاب درگاه پرداخت چه مواردی را بررسی کنیم؟

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

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

برای دریافت درگاه پرداخت اینترنتی چه پیش‌نیازهایی لازم است؟

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

پیش از ارسال درخواست این موارد را آماده کنید:

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

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

پرداخت اینترنتی فروشگاه در موبایل و نمایش نتیجه موفق تراکنش

اتصال فنی درگاه پرداخت به سایت چگونه انجام می‌شود؟

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

مرحله اول: ثبت سفارش در وضعیت در انتظار پرداخت

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

مرحله دوم: ارسال درخواست پرداخت از سمت سرور

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

مرحله سوم: هدایت مشتری به صفحه پرداخت

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

مرحله چهارم: دریافت Callback

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

مرحله پنجم: تأیید تراکنش یا Verify

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

مرحله ششم: نهایی‌سازی سفارش و ثبت رسید

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

تفاوت Callback و Verify چیست؟

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

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

خطاهای رایج در اتصال درگاه پرداخت

پرداخت انجام شده اما سفارش در سایت ثبت نشده است

ممکن است Callback به نشانی اشتباه ارسال شود، درخواست Verify با خطا مواجه شود یا ارتباط سرور با ارائه‌دهنده قطع شده باشد. شناسه سفارش و تراکنش را در گزارش‌ها بررسی کنید و امکان تطبیق مجدد وضعیت را در نظر بگیرید.

سفارش دوبار ثبت یا تحویل شده است

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

مبلغ تراکنش با مبلغ سفارش یکسان نیست

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

Callback به سایت نمی‌رسد

نشانی بازگشت اشتباه، دامنه تأییدنشده، گواهی SSL نامعتبر یا محدودیت‌های سرور می‌توانند باعث اختلال شوند. نشانی Callback را با تنظیمات پنل ارائه‌دهنده و دامنه فعال سایت تطبیق دهید.

مشتری پرداخت را لغو می‌کند یا ارتباط قطع می‌شود

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

چک‌لیست تست پیش از فعال‌سازی درگاه

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

مدیریت پرداخت در فروشگاه اینترنتی با ساعت صفر

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

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

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

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

پرسش‌های متداول درباره درگاه پرداخت اینترنتی

آیا Callback به‌تنهایی برای تأیید پرداخت کافی است؟

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

برای سایت تازه‌تأسیس درگاه مستقیم بهتر است یا پرداخت‌یار؟

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

چرا مشتری پرداخت موفق دارد اما سفارش در سایت ثبت نشده است؟

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

آیا برای اتصال درگاه به سایت به API نیاز داریم؟

در اتصال اختصاصی و خودکار معمولاً ارتباط API برای ایجاد تراکنش و Verify لازم است. برخی سامانه‌ها افزونه یا اتصال آماده دارند؛ روش دقیق به پلتفرم و ارائه‌دهنده بستگی دارد.

آیا می‌توان چند درگاه پرداخت روی یک سایت داشت؟

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

جمع‌بندی

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

فروشگاه اینترنتی خود را حرفه‌ای راه‌اندازی کنید

از Checkout یکپارچه تا مدیریت سفارش‌ها و عملیات فروش؛ زیرساخت فروش آنلاین خود را با ساعت صفر بسازید.

شروع ساخت سایت با ساعت صفر

برای بررسی نیازهای کسب‌وکارتان می‌توانید از صفحه تماس با ساعت صفر نیز استفاده کنید.

منابع و مستندات فنی بیشتر