پرسش‌های متداول

Base URL را به https://payment.sepal.ir تغییر دهید. مسیرهای قبلی مانند /api/request.json بدون تغییر قابل استفاده هستند.

منطق کسب‌وکار و بدنه درخواست یکسان است. تفاوت در ساختار URL است. جزئیات در راهنمای «نسخه‌ها و Base URL» آمده است.

بله. در ایجاد درخواست پرداخت، فیلد invoiceNumber اجباری است.

۱۰۰۰۰۰ ریال.

بله. پرداخت‌کننده باید از مرورگر و از سایت پذیرنده به /api/payment/{paymentNumber}/ هدایت شود تا هدر Referer (یا Origin) ارسال شود. فراخوانی مستقیم سرور‌به‌سرور بدون این هدر رد می‌شود.

بله. تأیید نهایی وضعیت تراکنش را قطعی می‌کند. اتکا صرف به پارامترهای callbackUrl کافی نیست.

بله. پس از موفقیت، تماس مجدد idempotent است و status همچنان true است. برای تشخیص بار اول از تماس بعدی از alreadyVerified استفاده کنید (false = اولین تأیید؛ true = قبلاً تأیید شده).

خیر. کلید apiKey باید در بدنه هر درخواست POST پذیرنده ارسال شود.

محیط آزمایشی با همان pathهای نسخه ۱ و پیشوند /api/v1/sandbox. بانک واقعی صدا زده نمی‌شود. پس از اتمام پیاده‌سازی، base_url را به https://payment.sepal.ir/api/v1 تغییر دهید و apiKey واقعی را بگذارید.

بله. دو مسیر دارید: ۱) شریک تجاری گیت‌لند برای اتصال چنددرگاهی به وردپرس — صفحه /partners؛ ۲) افزونه مستقیم سپال برای ووکامرس از بخش «ابزارها و افزونه‌ها» یا راهنمای «افزونه ووکامرس سپال». پس از نصب افزونه سپال، apiKey درگاه را در تنظیمات پرداخت وارد کنید.

بله. افزونه رسمی J2Store سپال (نسخه ۲.۰.۰) را از بخش «ابزارها و افزونه‌ها» یا راهنمای «افزونه J2Store سپال» دانلود و از مدیریت جوملا → نصب افزونه‌ها بارگذاری کنید. روی نسخه ۱.۰ قبلی مستقیم نصب می‌شود.