راهنمای مهاجرت از درگاه فعلی در ۴ گام
چطور بدون توقف فروش، از درگاه فعلی به شی‌پی منتقل شوید؛ از فهرست کردن نقاط اتصال تا جایگزینی کلید عملیاتی.
· ۸ دقیقه مطالعه · تیم شی‌پی
مهاجرت درگاه پرداخت اگر با برنامه انجام شود، یک پروژه کوچک و کم‌ریسک است. در این راهنما مسیری را توضیح می‌دهیم که فروش شما در هیچ لحظه متوقف نشود.
گام ۱: نقاط اتصال را فهرست کنید
- کجا پرداخت ایجاد می‌شود و چه اطلاعاتی ذخیره می‌شود؟
- صفحه callback چه کاری انجام می‌دهد و verify کجاست؟
- آیا استرداد، گزارش‌گیری یا مغایرت‌گیری خودکار دارید؟
- آیا افزونه آماده (مثلاً ووکامرس) استفاده می‌کنید یا کد اختصاصی؟
گام ۲: یکپارچه‌سازی در محیط آزمایشی
ثبت‌نام کنید و از بخش «API و درگاه‌ها» کلید sk_test_ بگیرید. لایه ارتباط با درگاه را طوری بنویسید که با یک تنظیم بین درگاه قدیم و جدید جابه‌جا شود. شناسه سفارش خود را در merchant_reference بفرستید و هدر Idempotency-Key را اضافه کنید.
گام ۳: همه سناریوها را آزمایش کنید
در صفحه پرداخت آزمایشی می‌توانید نتیجه را انتخاب کنید: موفق، ناموفق، انصراف مشتری و «تأخیر در تأیید» که حالت pending را شبیه‌سازی می‌کند. وب‌هوک‌ها را هم با ارسال آزمایشی و بررسی امضا تست کنید. همزمان، مدارک هویتی، تأیید دامنه و شبا را تکمیل کنید.
گام ۴: انتقال عملیاتی تدریجی
پس از تأیید مدارک و یک پرداخت آزمایشی موفق، حالت عملیاتی را فعال و کلید sk_live_ بسازید. اگر لایه شما امکان تقسیم ترافیک دارد، ابتدا بخش کوچکی از سفارش‌ها را منتقل کنید و نرخ موفقیت و تسویه‌ها را در داشبورد پایش کنید.
چه چیزی منتقل نمی‌شود؟
تاریخچه تراکنش‌های درگاه قبلی نزد همان درگاه می‌ماند. پیشنهاد می‌کنیم خروجی گزارش‌های قبلی را برای مراجعات حسابداری نگه دارید.
چک‌لیست تعاملی همین مراحل در دستیار مهاجرت پنل پذیرنده در دسترس است. صفحه مهاجرت