خطای پذیرنده معتبر نیست در درگاه بانکی

خطای “پذیرنده معتبر نیست” یا “Invalid Merchant” یکی از رایج ترین و در عین حال کلافه کننده ترین خطاهایی است که توسعه دهندگان و مدیران سایت های فروشگاهی پس از اتصال به درگاه پرداخت بانک با آن مواجه می شوند. این خطا به این معنی است که درگاه بانک، درخواست پرداخت ارسال شده از سوی وبسایت شما را به رسمیت نمی شناسد و آن را reject می کند.

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

علل بروز خطای “پذیرنده معتبر نیست”

خطا معمولاً به دلیل عدم تطابق یکی از پارامترهای ارسالی با اطلاعات ثبت شده در بانک رخ می دهد.

۱. آدرس IP سرور شما در سامانه بانک ثبت نشده است (مهمترین دلیل)

علت اصلی و کلیدی خطای “پذیرنده معتبر نیست” در بیشتر موارد، ثبت نشدن آدرس IP سرور شما در سامانه بانک یا پرداخت یار (مانند زیبال، سداد، آی دی پی و…) است. بانک ها و سرویس های درگاه پرداخت به دلایل امنیتی بسیار بالا، تنها درخواست هایی را از پیش پذیرفته می شوند که از آدرس های IP مشخص و از پیش تعریف شده (لیست سفید یا Whitelist) ارسال شده باشند. اگر IP سرور میزبان وبسایت یا سرویس شما در پنل مدیریت درگاه پرداخت ثبت نشده باشد، بانک هرگونه درخواست پرداختی از سمت شما را به عنوان یک “پذیرنده معتبر” نمی شناسد و آن را با همین خطا رد می کند. بنابراین، اولین و مهمترین قدم برای رفع این مشکل، یافتن آدرس IP اصلی سرور و افزودن آن به بخش “مدیریت آی پی های مجاز” در پنل درگاه پرداخت شماست.

• شرح مشکل: بانک ها برای افزایش امنیت، تنها درخواست های پرداختی را که از آدرس IP های از پیش تعریف شده (whitelist) ارسال شوند، می پذیرند.
• نشانه: خطا معمولاً در مرحله هدایت کاربر به درگاه بانک (Redirect) یا در مرحله بازگشت از بانک (Callback) رخ می دهد.

۲. مشکل در کد پذیرندگی (Merchant ID) یا ترمینال ID

• شرح مشکل: کد پذیرندگی (MID) یا شماره ترمینال (TID) اشتباه در درخواست پرداخت ارسال شده است.
• نشانه: خطا بلافاصله پس از ارسال درخواست به درگاه رخ می دهد.

۳. خطا در آدرس بازگشت (Callback URL)

• شرح مشکل: آدرس Callback ای که در درخواست پرداخت به بانک ارسال می کنید، با آدرسی که در سامانه بانک ثبت کرده اید، کاملاً (حرف به حرف) مطابقت ندارد.
• نشانه: تراکنش از دید کاربر موفق است، اما در بازگشت به سایت، خطای “پذیرنده معتبر نیست” را دریافت می کند و تراکنش در صندوق سایت شما ثبت نمی شود.

۴. مشکل در کلید واژه (Key) یا رمز عبور ترمینال

• شرح مشکل: کلید واژه (SHA-256 Key) یا رمز عبور ترمینال (Terminal Password) که برای ایجاد توکن/امضای دیجیتال (Sign) استفاده می شود، نادرست است یا به درستی در کدهای شما implement نشده است.
• نشانه: معمولاً بلافاصله پس از ارسال درخواست پرداخت، خطا رخ می دهد.

۵. عدم رعایت پروتکل HTTPS

• شرح مشکل: اکثر درگاه های بانکی جدید، تنها آدرس های Callback که تحت پروتکل امن HTTPS هستند را می پذیرند. استفاده از HTTP باعث بروز خطا می شود.
• نشانه: خطا در مرحله بازگشت از درگاه به سایت رخ می دهد.

راه حل های گام به گام برای رفع خطا

برای رفع این مشکل، مراحل زیر را به ترتیب اولویت بررسی کنید:

گام اول: ثبت آدرس IP سرور در سامانه بانک (مهمترین قدم)

1. آدرس IP اصلی سرور یا هاست خود را پیدا کنید. (می توانید با جستجوی “what is my ip” در گوگل یا مشاهده لاگ های cPanel آن را بیابید).
2. به پنل مدیریت درگاه پرداخت (مانند پنل سداد، پنل زیبال، یا پنل مستقیم بانک) وارد شوید.
3. در بخش تنظیمات درگاه یا مدیریت ترمینال، به دنبال گزینه ای با عنوان “آی پی سرور”، “مجازسازی آی پی” (IP Whitelisting) یا “آی پی قابل قبول” بگردید.
4. آدرس IP سرور خود را در این بخش وارد و ذخیره کنید.
5. تست مجدد: پس از ثبت IP، حتماً کش مرورگر را پاک کرده و مجدداً عملیات پرداخت را تست کنید.

گام دوم: بررسی صحت کد پذیرندگی و ترمینال ID

1. مطمئن شوید کد پذیرندگی (Merchant ID) و شماره ترمینال (Terminal ID) را به درستی از پنل بانک کپی کرده اید.
2. این مقادیر را با مقادیر موجود در کدهای سایت یا پلاگین درگاه پرداخت (مانند WooCommerce، ویژهمرت) مقایسه کنید. حتی یک کاراکتر کم یا زیاد می تواند باعث خطا شود.

گام سوم: تطبیق دقیق Callback URL

1. به پنل درگاه پرداخت بروید و آدرس Callback ثبت شده را بررسی کنید.
2. این آدرس باید دقیقاً با آدرسی که در کدهای شما وجود دارد، یکی باشد. به http یا https، www یا بدون www و حروف بزرگ و کوچک (Case-Sensitive) دقت کنید.
3. مطمئن شوید آدرس Callback شما تحت HTTPS است.

گام چهارم: بررسی کلید واژه (Key) و الگوریتم درست Signature

1. از correctness کلید واژه (Key) که از پنل بانک دریافت کرده اید، اطمینان حاصل کنید.
2. مطمئن شوید تابع hash_hmac در PHP یا تابع معادل در دیگر زبان ها، با الگوریتم درست (مثلاً SHA-256) و با ترتیب پارامترهای صحیح فراخوانی می شود.
3. نمونه کدهای ارائه شده توسط بانک را با دقت مطالعه و پیاده سازی کنید.

گام پنجم: عیب یابی پیشرفته با Logging

1. در کدهای خود، لاگ تمام داده هایی که به درگاه بانک ارسال می کنید (شامل MerchantID, TerminalID, CallbackURL, Amount, OrderId و Sign) را در یک فایل ثبت کنید.
2. همین داده ها را با اطلاعات پنل درگاه مقایسه کنید.
3. این کار به شما کمک می کند دقیقاً مشخص کنید کدام پارامتر مشکل دارد.