سوالات متداول فنی
- Base URL سرویس چیست؟
- دامنه تولید: https://payment.sepal.ir. مسیرهای نسخه قبلی تحت /api و مسیرهای نسخه ۱ تحت /api/v1 قرار دارند.
- در مهاجرت از sepal.ir چه تغییراتی لازم است؟
- Base URL را به https://payment.sepal.ir تغییر دهید. مسیرهای قبلی مانند /api/request.json بدون تغییر قابل استفاده هستند.
- تفاوت مسیر نسخه قبلی و نسخه ۱ چیست؟
- منطق کسبوکار و بدنه درخواست یکسان است. تفاوت در ساختار URL است. جزئیات در راهنمای «نسخهها و Base URL» آمده است.
- آیا invoiceNumber الزامی است؟
- بله. در ایجاد درخواست پرداخت، فیلد invoiceNumber اجباری است.
- حداقل مبلغ تراکنش چقدر است؟
- ۱۰۰۰۰۰ ریال.
- آیا پس از Callback فراخوانی verify الزامی است؟
- بله. تأیید نهایی وضعیت تراکنش را قطعی میکند. اتکا صرف به پارامترهای callbackUrl کافی نیست.
- آیا میتوان verify را بیش از یکبار فراخوانی کرد؟
- بله. پس از موفقیت، تماس مجدد idempotent است و status همچنان true است. برای تشخیص بار اول از تماس بعدی از alreadyVerified استفاده کنید (false = اولین تأیید؛ true = قبلاً تأیید شده).
- آیا سرویس احراز هویت جداگانه وجود دارد؟
- خیر. کلید apiKey باید در بدنه هر درخواست POST پذیرنده ارسال شود.
- سندباکس چیست و چطور به پروداکشن میروم؟
- محیط آزمایشی با همان pathهای نسخه ۱ و پیشوند /api/v1/sandbox. بانک واقعی صدا زده نمیشود. پس از اتمام پیادهسازی، base_url را به https://payment.sepal.ir/api/v1 تغییر دهید و apiKey واقعی را بگذارید.
آیا این صفحه مفید بود؟