درگاه بانکی
راهنمای افزودن، ویرایش و انتخاب درگاه بانکی در اینپی فای؛ تفاوت درگاه اختصاصی با درگاه اینپی فای و پیش‌نیاز دامنه پرداخت
درگاه بانکی مسیر دریافت وجه خریدهای مستقیم مشتریان است. در اینپی فای می‌توانید از درگاه اینپی فای استفاده کنید یا درگاه متعلق به کسب‌وکار خودتان را به پروژه متصل کنید. این تنظیم با کلیدهای اعتبارسنجی خرید کافه بازار و مایکت تفاوت دارد.
کدام مسیر پرداخت مناسب شماست؟
- درگاه اینپی فای: پرداخت از مسیر درگاه اینپی فای انجام می‌شود و درآمد آن طبق راهنمای درآمد درگاه و تصفیه حساب محاسبه می‌شود.
- درگاه اختصاصی شما: اطلاعات پذیرندگی خودتان را وارد می‌کنید. واریز وجه تابع قرارداد و روال شرکت ارائه‌دهنده همان درگاه است؛ این مسیر را با تصفیه حساب درآمد درگاه اینپی فای یکی ندانید.
- خرید فروشگاهی: خرید بازار و مایکت به تنظیمات همان فروشگاه در صفحه افزودن برنامه وابسته است؛ ساخت درگاه بانکی جای آن تنظیمات را نمی‌گیرد.
پیش‌نیازهای درگاه اختصاصی
پروژه را بسازید، اطلاعات پذیرندگی معتبر را از ارائه‌دهنده درگاه دریافت کنید و دسترسی مدیریت درگاه‌های پروژه را داشته باشید. استفاده از درگاه اختصاصی به فعال‌بودن این قابلیت در پلن حساب نیز وابسته است؛ اگر پیام ارتقای پلن می‌بینید، ظرفیت امکانات حساب را بررسی کنید.
پیش از خرید واقعی، دامنه اختصاصی پرداخت را ثبت، DNS آن را تأیید و HTTPS آن را فعال کنید. در مسیر انتخاب درگاه، درگاه اختصاصی پروژه بدون دامنه آماده انتخاب نمی‌شود؛ ممکن است پرداخت از درگاه پیش‌فرض اینپی فای انجام شود، اگر آن درگاه فعال و در دسترس باشد.
افزودن درگاه در پنل
۱. پروژه مورد نظر را از انتخاب‌گر پروژه انتخاب کنید.
۲. وارد تنظیمات پروژه ← درگاه‌های بانکی شوید و افزودن درگاه را بزنید.
۳. نوع درگاه را از فهرست انتخاب کنید. گزینه‌های فعلی شامل زرین‌پال، پی‌پینگ، زیبال، نکست‌پی، پی‌استار و جیبیت هستند؛ ملاک نهایی، گزینه‌های قابل انتخاب در پنل شماست.
۴. نامی مشخص برای درگاه وارد کنید؛ برای مثال «درگاه فروش وب». این نام برای شناسایی تنظیمات در پروژه است.
۵. کلید درگاه را از حساب پذیرندگی همان ارائه‌دهنده کپی کنید. این مقدار کلید SDK یا کلید محرمانه REST API اینپی فای نیست.
۶. اگر ارائه‌دهنده به کلید محرمانه نیاز دارد، مقدار آن را در کلید محرمانه درگاه وارد و تنظیمات را ذخیره کنید. نام و کاربرد اعتبارنامه‌ها میان ارائه‌دهندگان متفاوت است؛ آن‌ها را از راهنمای همان ارائه‌دهنده بردارید و حدس نزنید.
فعال‌سازی و انتخاب پیش‌فرض
در فهرست درگاه‌ها روی نام درگاه بزنید تا جزئیات آن باز شود. از بخش ویرایش می‌توانید نام، اطلاعات اتصال و وضعیت فعال‌بودن را مدیریت کنید. نمایش پوشیده کلیدها به معنای خالی‌بودن آن‌ها نیست؛ مقدار پوشیده را به‌عنوان یک کلید جدید وارد نکنید.
برای انتخاب پیش‌فرض، از منوی اقدامات کنار درگاه، انتخاب به‌عنوان پیش‌فرض را بزنید. فعال‌بودن درگاه و پیش‌فرض‌بودن دو تنظیم جدا هستند؛ درگاه غیرفعال برای خرید انتخاب نمی‌شود، حتی اگر پیش‌فرض باشد.
اگر پیشنهاد، قواعد انتخاب درگاه داشته باشد، درگاه فعال و مجاز مطابق آن قواعد بررسی می‌شود. در نبود انتخاب معتبر، درگاه فعال و پیش‌فرض اختصاصی پروژه با دامنه آماده بررسی می‌شود؛ سپس درگاه فعال و پیش‌فرض اینپی فای نقش مسیر جایگزین را دارد. بنابراین فقط از علامت پیش‌فرض نتیجه نگیرید که همه خریدها حتماً از همان درگاه می‌گذرند.
آزمون قبل از انتشار
- دامنه اختصاصی در وضعیت «فعال و امن» باشد.
- اطلاعات پذیرندگی، درگاه فعال و انتخاب پیش‌فرض را کنترل کنید.
- از همان برنامه یا لینک پرداخت مورد استفاده مشتری، یک خرید آزمایشی انجام دهید.
- انتقال به بانک، بازگشت به برنامه و وضعیت نهایی خرید را بررسی کنید؛ صرف بازگشت از بانک دلیل موفقیت پرداخت نیست.
- بررسی کنید خرید موفق، حق دسترسی مورد انتظار را به مشتری داده باشد؛ از راهنمای آزمون خرید استفاده کنید.
مشکلات رایج
- گزینه افزودن یا ویرایش دیده نمی‌شود: پروژه انتخاب‌شده و مجوزهای همکار پروژه را بررسی کنید.
- درگاه اختصاصی انتخاب نمی‌شود: فعال‌بودن درگاه، پیش‌فرض یا قواعد پیشنهاد و وضعیت DNS و HTTPS دامنه را کنترل کنید.
- اتصال درگاه خطا دارد: اعتبارنامه‌ها و وضعیت پذیرندگی را با ارائه‌دهنده بررسی کنید. اگر ارائه‌دهنده محدودیت دامنه بازگشت یا IP دارد، تنظیمات لازم را با پشتیبانی هماهنگ کنید؛ اتصال دامنه به‌تنهایی IP خروجی سرور را تغییر نمی‌دهد.
تغییر یا حذف درگاه
پیش از غیرفعال‌سازی یا حذف، مسیر جایگزین معتبر را آماده کنید و قواعد پیشنهادهایی را که به درگاه وابسته‌اند بررسی کنید. تغییر درگاه را هنگام خریدهای در حال انجام با احتیاط انجام دهید و کلیدهای آن را در برنامه، تصاویر عمومی یا مخزن کد منتشر نکنید.