پاسخ کوتاه: برای اتصال درگاه پرداخت به سایت اول باید اینماد فعال روی همان دامنه داشته باشید، بعد درگاه را از یک پرداختیار (درگاه واسط) یا مستقیم از یکی از شرکتهای PSP بگیرید و در آخر سایت را به آن وصل کنید. اگر سایت وردپرسی است، این کار با افزونه رسمی همان درگاه در حد تنظیم و تست است. اگر سایت اختصاصی دارید، برنامهنویس باید ارسال درخواست، بازگشت از درگاه و مرحله تأیید نهایی (verify) را درست پیاده کند. گرفتن خود درگاه معمولاً هزینهای ندارد؛ هزینه اصلی کارمزد هر تراکنش و هزینه یکباره کار فنی است.
بیشتر راهنماهایی که درباره درگاه پرداخت میخوانید فقط نصب افزونه ووکامرس را توضیح میدهند. ولی مشکلهای واقعی جای دیگری است: پولی که از حساب مشتری کم شده ولی سفارش ثبت نشده، سفارشی که دو بار پرداخت شده، مبلغی که به جای تومان به ریال رفته و درگاهی که چون دامنه با اینماد نمیخواند، فعال نمیشود. در این مطلب از انتخاب نوع درگاه شروع میکنیم، مدارک را مرتب میکنیم، مسیر یک پرداخت را قدم به قدم باز میکنیم و در آخر میگوییم کار فنی در ۱۴۰۵ حدوداً چقدر خرج دارد و قبل از روشن کردن درگاه چه چیزهایی را باید تست کنید.

درگاه مستقیم یا درگاه واسط؛ اول این را مشخص کنید
درگاه پرداخت در ایران دو مدل اصلی دارد. در درگاه مستقیم شما با یکی از شرکتهای ارائهدهنده خدمات پرداخت (PSP) که زیر نظر شاپرک کار میکنند قرارداد میبندید. در درگاه واسط با یک پرداختیار کار میکنید که خودش به PSPها وصل است و پول را برایتان تسویه میکند. پرداخت مشتری در هر دو مدل از شبکه شاپرک رد میشود؛ فرق در قرارداد، کارمزد، سرعت راهاندازی و امکانات جانبی است.
| معیار | درگاه مستقیم (PSP) | درگاه واسط (پرداختیار) |
|---|---|---|
| طرف قرارداد | شرکت PSP و معمولاً بانک | شرکت پرداختیار |
| سرعت راهاندازی | معمولاً کندتر؛ چند روز تا چند هفته | معمولاً سریعتر؛ گاهی در یکی دو روز کاری |
| مدارک | کاملتر؛ برای شرکتها مدارک حقوقی هم میخواهند | سادهتر؛ هویتی، اینماد و حساب بانکی |
| کارمزد | فقط کارمزد مصوب شبکه پرداخت | کارمزد شبکه بهاضافه سهم پرداختیار، معمولاً درصدی و سقفدار |
| تسویه | طبق چرخه تسویه شاپرک | بسته به پرداختیار؛ روزانه یا زودتر |
| امکانات جانبی | معمولاً فقط درگاه | لینک پرداخت، پنل گزارش، استرداد، چند درگاه پشتیبان |
| مستندات فنی | گاهی قدیمیتر و سختتر | معمولاً مستندات مرتب و کتابخانه آماده |
نرخ کارمزدها هر چند وقت یکبار تغییر میکند و هر پرداختیار تعرفه خودش را دارد. برای همین در این مطلب عدد کارمزد نمیدهیم؛ قبل از قرارداد، تعرفه بهروز را از سایت خود سرویس بگیرید و با میانگین مبلغ سبد خریدتان حساب کنید.
کدام مدل برای کدام کسبوکار؟
| وضعیت شما | انتخاب معقول | چرا |
|---|---|---|
| فروشگاه تازهکار با چند سفارش در روز | درگاه واسط | راهاندازی سریع و امکانات بیشتر؛ کارمزد اضافه در این حجم عدد بزرگی نمیشود |
| فروش ماهانه بالا با سبدهای متوسط تا بزرگ | درگاه مستقیم، یا مستقیم در کنار واسط | اختلاف کارمزد در حجم بالا قابل توجه است |
| سایت خدماتی، بیعانه نوبت یا فروش دوره | درگاه واسط | لینک پرداخت و استرداد ساده به کار میآید |
| شرکت یا سازمان با واحد مالی جدا | درگاه مستقیم | قرارداد رسمیتر و گزارشهای بانکی مستقیم |
| فروش حساس که قطعی برایش گران است | دو درگاه (اصلی و پشتیبان) | اگر یکی قطع شد، فروش متوقف نمیشود |
پیشنیازها؛ قبل از اینکه برنامهنویس کاری بکند
بیشتر پروژههای اتصال درگاه که عقب میافتند، گیرشان فنی نیست؛ گیر مدرک و تطبیق اطلاعات است. این موارد را از قبل آماده کنید:
- اینماد فعال: از سال ۱۴۰۰ برای هر درگاه اینترنتی جدید، چه مستقیم و چه واسط، نماد اعتماد الکترونیکی لازم است. اگر اینماد معلق یا منقضی شود، درگاه هم ممکن است قطع شود.
- یکی بودن دامنه: آدرس سایتی که برای درگاه ثبت میکنید باید همان آدرسی باشد که اینماد برایش صادر شده. سایت آزمایشی روی دامنه دیگر یا زیردامنه جدا را از قبل هماهنگ کنید.
- یکی بودن هویت: صاحب اینماد، صاحب درگاه و صاحب حساب بانکی (شبا) باید یک شخص یا یک شرکت باشند.
- پرونده مالیاتی: درگاهها معمولاً به پرونده مالیاتی کسبوکار وصل میشوند و اطلاعات آن را موقع ثبت میخواهند.
- SSL و صفحات لازم سایت: سایت باید روی HTTPS باشد و صفحههای قوانین، تماس و شرایط بازگشت کالا یا وجه را داشته باشد.
- سرور: بعضی متدهای درگاه، مثل استرداد یا استعلام، فقط از IP ثبتشده سرور جواب میدهند. اگر سرور یا CDN شما خارج از ایران است، قبل از شروع از پشتیبانی درگاه بپرسید.
مسیر یک پرداخت در سایت، قدم به قدم
فرقی نمیکند درگاه شما چیست؛ تقریباً همه درگاههای ایرانی همین الگو را دارند. دانستن این مسیر کمک میکند بفهمید برنامهنویس دقیقاً چه چیزی باید بسازد و اشکال معمولاً کجاست:
| مرحله | چه اتفاقی میافتد | چه چیزی ممکن است خراب شود |
|---|---|---|
| ۱. ساخت سفارش | سایت سفارش را با وضعیت «در انتظار پرداخت» ثبت میکند و مبلغ را خودش حساب میکند | مبلغ از سمت مرورگر خوانده شود و قابل دستکاری باشد |
| ۲. درخواست پرداخت | سایت مبلغ، شماره سفارش و آدرس بازگشت را برای درگاه میفرستد و یک شناسه پرداخت میگیرد | مبلغ تومان به جای ریال ارسال شود؛ آدرس بازگشت با دامنه ثبتشده نخواند |
| ۳. انتقال به درگاه | مشتری به صفحه پرداخت بانکی میرود و اطلاعات کارت را وارد میکند | مشتری صفحه را میبندد یا رمز پویا دیر میرسد |
| ۴. بازگشت به سایت | درگاه مشتری را با نتیجه اولیه به آدرس بازگشت برمیگرداند | اینترنت مشتری قطع میشود و اصلاً به سایت برنمیگردد |
| ۵. تأیید نهایی (verify) | سایت از سرور خودش از درگاه میپرسد پرداخت واقعاً انجام شده یا نه و فقط بعد از جواب مثبت سفارش را «پرداختشده» میکند | verify انجام نشود یا دیر انجام شود؛ پول از حساب مشتری کم شده ولی سفارش ثبت نشده |
| ۶. بعد از پرداخت | کم شدن موجودی، پیامک یا ایمیل تأیید، ثبت کد پیگیری در پنل | رفرش صفحه باعث شود سفارش دو بار تأیید یا موجودی دو بار کم شود |
نکته مهم مرحله پنجم: در خیلی از درگاهها اگر تأیید نهایی در مهلت مشخصی انجام نشود، پول به حساب مشتری برمیگردد. بعضی درگاهها هم پول را برنمیگردانند و تراکنش را در لیست «تأییدنشدهها» نگه میدارند تا خودتان تکلیفش را روشن کنید. سایت شما باید هر دو حالت را بشناسد و یک کار زمانبندیشده داشته باشد که هر چند دقیقه یکبار این تراکنشها را پیدا و تکلیفشان را روشن کند. اگر این کار نباشد، پشتیبانی شما هر هفته با مشتریای سروکار دارد که میگوید «پول کم شد ولی سفارش ثبت نشد». برای ریشهیابی این مشکل در فروشگاهی که الان کار میکند، مطلب پرداخت ناموفق در فروشگاه اینترنتی را هم بخوانید.

وضعیت سفارش و جلوگیری از پرداخت دوباره
سایتی که درگاهش درست وصل شده، برای هر سفارش وضعیت روشن دارد و هیچ مرحلهای دو بار اجرا نمیشود. حداقل این وضعیتها را داشته باشید:
- در انتظار پرداخت: سفارش ساخته شده و مشتری هنوز به درگاه نرفته یا برنگشته است.
- در حال بررسی: مشتری برگشته ولی جواب تأیید نهایی هنوز نیامده. این وضعیت جلوی ثبت دوباره را میگیرد.
- پرداختشده: تأیید نهایی موفق بوده و کد پیگیری بانکی ذخیره شده است.
- ناموفق یا لغوشده: مشتری انصراف داده یا بانک رد کرده؛ موجودی رزروشده آزاد میشود.
- مسترد شده: مبلغ کامل یا بخشی از آن به مشتری برگشته است.
چند قاعده ساده هم بیشتر دردسرها را از بین میبرد. هر شناسه پرداخت فقط یکبار تأیید شود. اگر مشتری برای یک سفارش دو بار پرداخت کرد، دومی خودکار علامت بخورد تا مسترد شود. مبلغ همیشه از روی سفارش ذخیرهشده در سرور خوانده شود. کلید یا کد پذیرنده درگاه هم داخل کد یا مخزن گیت نماند و در تنظیمات امن سرور نگه داشته شود.
اتصال درگاه در وردپرس، سایت اختصاصی و اپلیکیشن
| نوع سایت | روش اتصال | کار اصلی |
|---|---|---|
| وردپرس و ووکامرس | افزونه رسمی خود درگاه | نصب، وارد کردن کد پذیرنده، تنظیم واحد پول و تست؛ از افزونههای نالشده یا ناشناس استفاده نکنید |
| سایت اختصاصی (Next.js، جنگو، لاراول و…) | پیادهسازی با API درگاه | درخواست پرداخت، صفحه بازگشت، تأیید نهایی، کار زمانبندیشده بررسی، گزارش در پنل |
| اپلیکیشن موبایل یا ربات | همان API، ولی از طریق سرور | کد پذیرنده هیچوقت داخل اپ نباشد؛ اپ فقط آدرس پرداخت را از سرور میگیرد |
| چند درگاه همزمان | یک لایه پرداخت مشترک در سایت | انتخاب درگاه، درگاه پشتیبان هنگام قطعی و گزارش یکپارچه |
در سایت اختصاصی بهتر است پرداخت یک بخش جدا در کد باشد، نه چند خط پراکنده داخل صفحه سبد خرید. اینطوری اگر فردا خواستید درگاه را عوض کنید یا درگاه دوم اضافه کنید، فقط همان بخش تغییر میکند. برای اینکه بدانید کارهای پشت صحنه سایت اختصاصی معمولاً چطور قیمتگذاری میشوند، مطلب هزینه طراحی API را ببینید.
درگاه پشتیبان کی ارزش دارد؟
اگر فروش شما در ساعتهای شلوغ یا روزهای حراج سنگین است، قطع شدن تنها درگاه یعنی چند ساعت فروش از دست رفته. با دو درگاه، سایت میتواند در صورت خطا مشتری را به درگاه دوم بفرستد یا در صفحه پرداخت دو گزینه نشان دهد. هزینهاش یک ثبتنام دیگر، کمی کار فنی بیشتر و گزارشگیری از دو پنل است. برای فروشگاهی با چند سفارش در روز معمولاً لازم نیست. برای فروشگاهی که کمپینهای بزرگ دارد معمولاً میارزد.
استرداد وجه و تطبیق با تسویه
کار درگاه با پرداخت موفق تمام نمیشود. دو موضوع را از روز اول در پنل مدیریت ببینید:
- استرداد: برای لغو سفارش یا مرجوعی، روشن کنید پول از کجا برمیگردد: از پنل درگاه، با متد استرداد خود درگاه یا با کارت به کارت دستی. بعضی درگاهها برگشت فوری بدون کارمزد را فقط تا مدت کوتاهی بعد از پرداخت قبول میکنند. بعد از آن باید از روش استرداد معمولی استفاده کرد. هر استرداد هم باید در خود سفارش ثبت شود.
- تطبیق روزانه: جمع پرداختهای موفق سایت در یک روز باید با گزارش تراکنشهای پنل درگاه یکی باشد و مبلغ تسویهشده هم با کسر کارمزد به حسابتان بنشیند. یک گزارش ساده مغایرت در پنل، اختلافها را قبل از اینکه به یک مشکل بزرگ تبدیل شوند نشان میدهد.
اگر فروش اقساطی یا روشهای «الان بخر، بعداً پرداخت کن» هم دارید، آنها مسیر جدایی دارند که در مطلب فروش اقساطی در سایت توضیح دادهایم.

هزینه اتصال درگاه پرداخت به سایت در ۱۴۰۵
این هزینه دو بخش دارد. بخش اول هزینه خود درگاه است که معمولاً هزینه راهاندازی ندارد و فقط از هر تراکنش کارمزد کم میشود. بخش دوم هزینه یکباره کار فنی است. این بخش به نوع سایت و دقت پیادهسازی بستگی دارد. بازههای زیر تقریبی است و برای برآورد اولیه کاربرد دارد:
| نوع کار | شامل چه چیزهایی | بازه تقریبی (تومان، ۱۴۰۵) | زمان معمول |
|---|---|---|---|
| نصب و تنظیم افزونه در ووکامرس | نصب افزونه رسمی، تنظیم واحد پول، صفحه تشکر، یک دور تست | حدود ۱ تا ۵ میلیون | یک تا سه روز بعد از فعال شدن درگاه |
| اتصال یک درگاه به سایت اختصاصی | درخواست پرداخت، صفحه بازگشت، تأیید نهایی، وضعیت سفارش، لاگ تراکنش | حدود ۸ تا ۲۵ میلیون | حدود یک تا دو هفته |
| اتصال کامل با پنل و بررسی خودکار | موارد بالا بهاضافه بررسی زمانبندیشده تراکنشهای تأییدنشده، استرداد از پنل، گزارش روزانه | حدود ۲۰ تا ۴۵ میلیون | حدود دو تا سه هفته |
| چند درگاه با درگاه پشتیبان و تطبیق مالی | لایه پرداخت مشترک، انتخاب و جابهجایی درگاه، گزارش مغایرت | حدود ۳۵ تا ۷۵ میلیون و بیشتر | حدود سه تا شش هفته |
این موارد معمولاً در این عددها نیست و باید جدا پرسیده شود: گرفتن اینماد و کارهای اداری، طراحی دوباره صفحه سبد خرید و تسویه، اتصال به حسابداری یا سامانه مودیان، کیف پول داخلی سایت و پشتیبانی ماهانه. اگر هنوز فروشگاه ندارید و کل پروژه را میخواهید برآورد کنید، مطلب هزینه طراحی فروشگاه اینترنتی ۱۴۰۵ تصویر کاملتری میدهد. تعرفههای کلی پونوکد هم در صفحه تعرفهها آمده است.
تستهایی که قبل از روشن کردن درگاه باید انجام شود
پیشنهاد ما این است که این سناریوها را با مبلغ کم و پرداخت واقعی، یا در محیط آزمایشی درگاه اگر دارد، یکییکی امتحان کنید:
| سناریو | نتیجه درست |
|---|---|
| پرداخت موفق عادی | سفارش «پرداختشده»، کد پیگیری در پنل و پیامک تأیید برای مشتری |
| انصراف در صفحه بانک | سفارش «ناموفق» و برگشت مشتری به سبد خرید با پیام روشن |
| بستن مرورگر بعد از پرداخت | بررسی خودکار تراکنش را پیدا و سفارش را درست ثبت میکند |
| رفرش صفحه بازگشت | سفارش دو بار تأیید نمیشود و موجودی دو بار کم نمیشود |
| تغییر مبلغ در مرورگر | مبلغ از سرور خوانده میشود و تغییری در پرداخت ایجاد نمیشود |
| دو پرداخت برای یک سفارش | پرداخت دوم برای استرداد علامت میخورد |
| قطع بودن درگاه | پیام مناسب به مشتری یا انتقال به درگاه پشتیبان |
| استرداد از پنل مدیریت | مبلغ برمیگردد و در سفارش ثبت میشود |
چکلیست اتصال درگاه پرداخت به سایت
- اینماد فعال روی همان دامنهای است که درگاه برایش ثبت میشود.
- صاحب اینماد، صاحب درگاه و صاحب حساب بانکی یکی هستند.
- نوع درگاه (مستقیم، واسط یا هر دو) با توجه به حجم فروش انتخاب شده است.
- تعرفه کارمزد و چرخه تسویه بهروز از خود سرویس گرفته شده است.
- سایت روی HTTPS است و صفحه قوانین و شرایط بازگشت وجه دارد.
- واحد پول (ریال یا تومان) در ارسال به درگاه چک شده است.
- مبلغ فقط از سفارش ذخیرهشده در سرور خوانده میشود.
- تأیید نهایی سمت سرور انجام میشود و هر پرداخت فقط یکبار تأیید میشود.
- بررسی زمانبندیشده تراکنشهای تأییدنشده فعال است.
- کد پذیرنده درگاه در تنظیمات امن سرور است، نه داخل کد.
- استرداد از پنل مدیریت انجام و در سفارش ثبت میشود.
- گزارش روزانه با پنل درگاه تطبیق داده میشود.
- همه سناریوهای جدول تست بالا اجرا شدهاند.
اگر سایت اختصاصی دارید یا میخواهید بسازید
در پونوکد پرداخت را از روال واقعی فروش شما شروع میکنیم: چه چیزی میفروشید، مرجوعی چطور است، چه کسی گزارش مالی را میبیند. بعد درگاه را طوری وصل میکنیم که عوض کردن یا اضافه کردن درگاه بعدها ساده باشد. اگر قرار است سایتتان را از اول بسازید، صفحه طراحی سایت را ببینید. برای اتصال یک سایت آماده هم فهرست کامل کارها در صفحه خدمات پونوکد آمده است.
جمعبندی
اتصال درگاه پرداخت به سایت سه بخش دارد: کار اداری (اینماد، تطبیق دامنه و هویت، پرونده مالیاتی)، انتخاب درست (مستقیم، واسط یا هر دو) و کار فنی (درخواست، بازگشت، تأیید نهایی، بررسی خودکار و استرداد). در وردپرس، بخش فنی بیشتر تنظیم و تست است. در سایت اختصاصی، کیفیت پیادهسازی تعیین میکند چند بار در ماه با مشتریای سروکار داشته باشید که پولش کم شده و سفارشش ثبت نشده. قبل از شروع فروش، سناریوهای تست را کامل اجرا کنید.
سؤالهای رایج
بدون اینماد میشود درگاه پرداخت گرفت؟
برای درگاههای جدید، نه. از سال ۱۴۰۰ هم درگاه مستقیم و هم درگاه واسط برای سایت فقط به کسبوکارهای دارای اینماد داده میشود. استفاده از درگاه به نام شخص دیگر هم خلاف مقررات است و ممکن است درگاه را مسدود کند.
گرفتن درگاه پرداخت هزینه دارد؟
معمولاً خود درگاه هزینه راهاندازی ندارد و از هر تراکنش کارمزد کم میشود. هزینه جدا مربوط به کار فنی اتصال است که در وردپرس کم و در سایت اختصاصی بیشتر است.
درگاه مستقیم بهتر است یا واسط؟
برای شروع و فروش کم تا متوسط، درگاه واسط معمولاً راحتتر است. وقتی حجم فروش بالا رفت، درگاه مستقیم به خاطر کارمزد کمتر ارزش بررسی دارد. خیلی از فروشگاهها هم هر دو را نگه میدارند.
چرا پول از حساب مشتری کم شده ولی سفارش ثبت نشده؟
معمولاً مرحله تأیید نهایی انجام نشده یا دیر انجام شده است، مثلاً چون مشتری به سایت برنگشته. بسته به تنظیم درگاه، پول بعد از مدتی خودکار برمیگردد یا در لیست تأییدنشدهها میماند. سایت باید این تراکنشها را خودکار بررسی و تکلیفشان را روشن کند.
اتصال درگاه به سایت اختصاصی چقدر طول میکشد؟
بعد از فعال شدن درگاه، یک اتصال ساده معمولاً یک تا دو هفته کار و تست دارد. اتصال کامل با پنل استرداد، بررسی خودکار و گزارش، معمولاً دو تا سه هفته.
میشود بعداً درگاه را عوض کرد؟
بله. اگر پرداخت در کد سایت یک بخش جدا باشد، عوض کردن یا اضافه کردن درگاه کار کوچکی است. اگر کد پرداخت در چند جای سایت پخش شده باشد، هزینه تغییر بیشتر میشود.
مشاوره اتصال درگاه پرداخت با رامین اسلامی
اگر نمیدانید کدام درگاه برای سایت شما مناسبتر است یا درگاه فعلیتان مشکل تأیید نشدن پرداخت دارد، نوع سایت و روال فروشتان را بفرستید تا راه پیشنهادی و برآورد اولیه را بگوییم: تلفن ۰۹۹۱۵۶۱۵۹۴۶، تلگرام t.me/resonea یا فرم تماس.
اگر به وبلاگهای حوزه تکنولوژی روز دنیا علاقهمندید، میتوانید به وبسایت شخصی من هم سر بزنید: ramineslami.ir/blogs



