خطاهای درگاه پرداخت

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

اگر در پی خطاهای مربوط به شاپرک هستید می‌توایند مقاله “ خطاهای شاپرک” را بررسی کنید.

اتصال به درگاه بانکی در ۴ مرحله صورت می‌گیرد که خطاهای مربوط به هر مرحله به شرح زیر است :

درخواست توکن

زمانی که شما از رایان پی، سرویس درگاه پرداخت را تهیه کرده باشید، اطلاعاتی مانند شناسه مشتری، رمز عبور مشتری و شناسه یکتا در اختیار شما قرار داده شده است، این اطلاعات هویت شما در شبکه پرداخت است. بنابراین در گام اول که درخواست توکن است، باید مشخص شود، چه هویتی تقاضای اتصال به شبکه پرداخت را دارد.

خطاهای ممکن در زمان درخواست توکن :

• نقص در پارامترهای ارسالی

• کد کاربری/رمز عبور /کلاینت/آی پی نامعتبر است

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

اگر از افزونه ووکامرس رایان پی استفاده می‌کنید، تنظیمات درگاه در ووکامرس را مجدد بررسی نمایید تا اطلاعات به درستی وارد شده باشد.

در صورت استفاده از API نیز، اطلاعات ارسالی مرچنت خود را بازنگری کنید.

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

درخواست پرداخت

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

خطاهای ممکن در زمان درخواست پرداخت :

• اتصال به درگاه خطا دارد (پرداخت ناموفق)

زمانی که یکی از پارامترهای ارسالی مانند مبلغ، شماره موبایل و … به درستی ارسال نشود، این خطا مشاهده خواهد شد.

توجه کنید در زمان ثبت سفارش مقدار مبلغ (ریال) و شماره موبایل با فرمت صحیح وارد شوند.

• • فرمت صحیح موبایل در زمان ثبت سفارش وردپرس : ۰۹XXXXXXXXX
  • فرمت صحیح موبایل در API : 989XXXXXXXXX
  • فرمت صحیح مبلغ : اعداد صحیح (۲۰۰۰۰۰)

وضعیت درخواست

تعیین وضعیت درخواست، بدین معنی است که مشتری می تواند، وضعیت پرداخت را با استفاده از شماره سفارش، از رایان پی، پیگیری نماید.

خطاهای درگاه پرداخت ممکن در وضعیت درخواست :

• پرداخت موفق
• پرداخت ناموفق
• پرداخت در حالت Pending می باشد و باید متد fullfill برای تعیین وضعیت صدا زده شود.
• توکن نامعتبر است

تایید پرداخت

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

خطاهای ممکن در تایید پرداخت :

• پرداخت ناموفق (تراکنش ناموفق بوده است.)

زمانی رخ می‌دهد که کاربر از پرداخت خود منصرف شده است یا در مدت زمان ۱۵ دقیقه پرداخت خود را انجام نداده است.

وضعیت پرداخت نامعتبر می باشد.

توکن نامعتبر است

پرداخت در حالت Pending می باشد و باید متد fullfill برای تعیین وضعیت صدا زده شود

پرداخت یافت نشد

قوانین پرداخت یافت نشد (برای پرداخت هایی که قوانین دارند)