درگاه پرداخت سامان (سپ) برای ووکامرس — KJNR افزونه اختصاصی شرکت کلید جهان نمای رایا برای اتصال فروشگاه ووکامرس به درگاه پرداخت الکترونیک سامان است. این افزونه مطابق مستند IPG نسخه ۳.۶ و neo-pg نسخه ۱.۰ (دی ۱۴۰۲) پیاده‌سازی شده و برای فروشگاه‌های آنلاین ایرانی طراحی شده است.

این محصول کاملاً رایگان و بدون لایسنس عرضه می‌شود. هیچ هزینه فعال‌سازی، اشتراک یا محدودیت لایسنس ندارد و می‌توانید آزادانه در فروشگاه خود استفاده کنید. کد این افزونه به‌صورت اختصاصی توسط تیم کلید جهان نمای رایا (KJNR) نوشته شده است.

ویژگی‌های کلیدی

  • پرداخت امن از طریق درگاه سامان (SEP) با جریان توکنی
  • Verify اجباری پس از بازگشت از درگاه — بدون تکیه صرف به Callback
  • جلوگیری از Double Spending با کنترل یکتایی RefNum
  • پشتیبانی از بلو‌پی / neo-pg (هدایت از هدر X-IPG-Url)
  • سازگاری با WooCommerce Blocks Checkout و HPOS
  • پشتیبانی از بازگشت وجه (Reverse) طبق محدودیت زمانی سامان
  • ارسال شماره موبایل خریدار به درگاه (اختیاری)
  • لاگ اشکال‌زدایی، تشخیص IP سرور و تنظیم لوگوی روش پرداخت

نیازمندی‌ها

  • وردپرس ۶.۴ یا بالاتر
  • ووکامرس ۸.۰ یا بالاتر (تست‌شده تا ۱۱.۱)
  • PHP ۸.۱ یا بالاتر
  • ترمینال فعال درگاه پرداخت الکترونیک سامان
  • HTTPS روی سایت فروشگاه

نصب و راه‌اندازی

  1. فایل ZIP را از این صفحه دانلود کنید.
  2. در پیشخوان وردپرس به افزونه‌ها ← افزودن ← بارگذاری افزونه بروید و فایل را نصب کنید.
  3. افزونه را فعال کنید.
  4. به ووکامرس ← پیکربندی ← پرداخت‌ها بروید و درگاه «سامان (سپ) — KJNR» را فعال کنید.
  5. شماره ترمینال سامان را وارد کرده و تنظیمات را ذخیره کنید.

امنیت تراکنش

پس از بازگشت کاربر از درگاه، افزونه تراکنش را با سرویس Verify سامان تأیید می‌کند، مبلغ و شماره ترمینال را تطبیق می‌دهد و در صورت مغایرت، Reverse درخواست می‌کند. شناسه ResNum یکتا برای هر سفارش تولید می‌شود تا از تکرار و سوءاستفاده جلوگیری شود.

پشتیبانی

این محصول توسط شرکت کلید جهان نمای رایا (KJNR) توسعه یافته است. در صورت مشاهده باگ یا مشکل، از دکمه «گزارش باگ یا مشکل» در همین صفحه استفاده کنید.