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

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

برای تست در محیط عملیاتی، ابتدا باید تنظیمات واقعی درگاه را در سایت خود اعمال کنید:

• درگاه را در حالت «فعال» (لایو) قرار دهید و حالت آزمایشی (Sandbox) را غیرفعال کنید.
• آدرس بازگشت (Callback URL) صحیح را در پنل پذیرندگان اسنپ‌پی ثبت کنید. این آدرس صفحه‌ای در سایت شماست که کاربر پس از پرداخت به آن هدایت می‌شود.
• کلیدهای API (مرچنت آیدی) مربوط به محیط عملیاتی را در افزونه یا کد سایت خود وارد کنید.
• وایت‌لیست IP (در صورت نیاز): IPهای اعلام‌شده توسط اسنپ‌پی را در فایروال سرور و افزونه‌های امنیتی مجاز کنید تا درخواست‌های ارسالی از سمت درگاه به سایت شما مسدود نشوند.
• اگر از CDN یا سرویسی مثل Cloudflare استفاده می‌کنید، مطمئن شوید درخواست‌های ورودی از IPهای درگاه فیلتر نمی‌شوند.

حال نوبت به انجام یک خرید واقعی به عنوان یک مشتر واقعی می‌رسد. حتماً از مبلغ بسیار پایین (مثلاً ۱,۰۰۰ یا ۲,۰۰۰ تومان) استفاده کنید تا ریسک مالی نداشته باشید. این تست را خودتان یا یکی از اعضای تیم انجام دهید.

✅ سناریوی ۱: پرداخت موفق و بررسی ارسال تراکنش

• یک محصول با قیمت تستی (مثلاً ۱,۰۰۰ تومان) به سبد خرید اضافه کنید.
• فرآیند تسویه حساب را طی کرده و درگاه اسنپ‌پی را انتخاب کنید.
• در صفحه درگاه، اطلاعات کارت بانکی واقعی یکی از اعضای تیم را وارد کنید.
• رمز دوم پویا یا رمز یکبارمصرف را وارد کرده و پرداخت را تأیید کنید.
• پس از اتمام پرداخت، سیستم باید شما را به آدرس بازگشت (Callback) در سایت هدایت کند.
• نحوه ارسال و دریافت اطلاعات را بررسی کنید:
  • پیام «پرداخت موفق» به کاربر نمایش داده شود.
  • سفارش در سایت شما با وضعیت «پرداخت شده» یا «در حال پردازش» ثبت شود.
  • ایمیل و پیامک تأیید سفارش برای خریدار ارسال گردد.
  • شماره تراکنش (Transaction ID) و مبلغ در سیستم شما ذخیره شده باشد.

❌ سناریوی ۲: انصراف کاربر از پرداخت

• مراحل مشابه را طی کنید، اما در صفحه درگاه بانک، گزینه «انصراف» یا «بازگشت» را بزنید.
• بررسی کنید که: کاربر به صفحه بازگشت با پیام مناسب (مثلاً «پرداخت لغو شد») هدایت شود و سفارش در سیستم با وضعیت «لغو شده» یا «در انتظار پرداخت» ثبت گردد.

⚠️ سناریوی ۳: خطا در حین پرداخت (موجودی ناکافی یا رمز اشتباه)

• عمداً یک خطا ایجاد کنید، مثلاً موجودی کارت را کم کنید یا رمز دوم را اشتباه وارد کنید.
• بررسی کنید که: پیام خطای مناسب و واضح به کاربر نمایش داده شود و سفارش در وضعیت «ناموفق» یا «خطا در پرداخت» قرار گیرد.

مهم‌ترین بخش تست، اطمینان از دریافت و پردازش صحیح اطلاعات بازگشتی از درگاه است. درگاه پس از پرداخت، اطلاعات تراکنش (شامل وضعیت، شماره تراکنش، مبلغ و ...) را به آدرس Callback شما ارسال می‌کند. برای اطمینان از عملکرد صحیح این بخش:

• پس از یک پرداخت موفق تستی، لاگ‌های سرور خود را بررسی کنید.
• مطمئن شوید یک درخواست (POST یا GET) از سمت درگاه به آدرس Callback شما رسیده است.
• بررسی کنید که پارامترهای مهم مثل status (موفق/ناموفق)، transaction_id (شماره تراکنش)، amount (مبلغ) و order_id به درستی دریافت شده‌اند.
• اطمینان حاصل کنید که سیستم شما پاسخ HTTP 200 (OK) به درگاه برمی‌گرداند (در غیر این صورت درگاه فکر می‌کند تراکنش ناموفق بوده است).
• بررسی کنید که رکورد تراکنش با وضعیت صحیح در دیتابیس شما ذخیره شده است.

اگر کسب‌وکار شما نیاز به بازگشت وجه به مشتری دارد (مثلاً به دلیل انصراف یا نقص کالا)، حتماً این سناریو را نیز تست کنید:

• پس از یک تراکنش موفق تستی (با مبلغ پایین)، وارد پنل پذیرندگان اسنپ‌پی شوید.
• تراکنش مورد نظر را پیدا کرده و گزینه «بازگشت وجه» یا «Refund» را انتخاب کنید.
• مبلغ مورد نظر (یا کل تراکنش) را وارد کرده و تأیید کنید.
• بررسی کنید که:
  • وضعیت تراکنش در سیستم شما به «بازگشت وجه خورده» تغییر کند.
  • در صورت وجود، ایمیل اطلاع‌رسانی بازگشت وجه برای مشتری ارسال شود.
  • وجه واقعی ظرف چند روز به حساب بانکی مرتبط با کارت مبدأ بازگردد (در تست واقعی این اتفاق می‌افتد).

پس از اطمینان از عملکرد صحیح تمام سناریوها:

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

• درگاه در حالت فعال (لایو) قرار دارد و تنظیمات Callback درست ثبت شده است.
• IPهای درگاه در فایروال و کلودفلر وایت‌لیست شده‌اند (در صورت نیاز).
• یک تراکنش موفق واقعی با مبلغ پایین (۱,۰۰۰ تومان) انجام شده و سفارش در سایت ثبت شده است.
• ایمیل و پیامک تأیید سفارش به درستی ارسال شده‌اند.
• سناریوی انصراف کاربر تست شده و پیام مناسب نمایش داده می‌شود.
• سناریوی خطا در پرداخت (رمز اشتباه، موجودی کم) تست شده است.
• لاگ‌های سرور بررسی شده و درخواست Callback با موفقیت دریافت شده است.
• فرآیند بازگشت وجه (در صورت نیاز) تست شده و وضعیت به روز می‌شود.
• محصول تستی پس از تأیید نهایی حذف یا غیرفعال شده است.