سندباکس
محیط آزمایشی با همان مسیرهای درگاه — بدون بانک و تراکنش واقعی
- بدون بانک و تراکنش واقعی
- قرارداد API یکسان با پروداکشن
- هر apiKey غیرخالی پذیرفته میشود
Base URL
یک قرارداد، دو محیط
مسیرها و بدنه درخواستها یکی است؛ برای رفتن به پروداکشن فقط پایه آدرس را عوض کنید.
سندباکس
برای توسعه و تستhttps://payment.sepal.ir/api/v1/sandboxپروداکشن
تراکنش واقعیhttps://payment.sepal.ir/api/v1جرنی پرداخت
شش مرحله آزمایشی
همان جرنی درگاه واقعی؛ در مرحله دوم بهجای بانک، صفحه درگاه آزمایشی با دکمه موفق / ناموفق نمایش داده میشود.
ایجاد درخواست پرداخت
POST/payment/request/با هر apiKey غیرخالی درخواست بسازید و paymentNumber بگیرید.
صفحه درگاه آزمایشی
GET/payment/{paymentNumber}/کاربر را به این آدرس هدایت کنید؛ دکمه موفق یا ناموفق نتیجه پرداخت را تعیین میکند.
بازگشت به پذیرنده
شبیهساز بانکPOST/payment/{paymentNumber}/callback/سندباکس نقش بانک را بازی میکند و نتیجه را به callbackUrl شما برمیگرداند.
تأیید نهایی
POST/payment/verify/از سمت سرور خودتان پرداخت را Verify کنید — دقیقاً مثل پروداکشن.
استعلام وضعیت
POST/payment/state/وضعیت لحظهای هر پرداخت را با paymentNumber استعلام بگیرید.
جستجوی تراکنشها
POST/payment/inquiry/فهرست تراکنشهای آزمایشی را فیلتر و بررسی کنید.
Go-Live
رفتن به پروداکشن
سه قدم تا پرداخت واقعی — بدون هیچ تغییری در کد یکپارچهسازی.
پیادهسازی را روی سندباکس کامل کنید و Verify را از سرور خودتان بزنید.
مقدار base_url را از آدرس سندباکس به آدرس پروداکشن تغییر دهید.
apiKey واقعی درگاه را از پنل سپال جایگزین کنید.
https://payment.sepal.ir/api/v1/sandboxhttps://payment.sepal.ir/api/v1نکتهها
سندباکس برای پیادهسازی و تشخیص خطا است. قرارداد API با پروداکشن یکی است؛ فقط base URL فرق دارد. بانک واقعی صدا زده نمیشود و رکوردها از پرداختهای زنده جدا هستند.
Base URL سندباکس: https://payment.sepal.ir/api/v1/sandbox — Base URL پروداکشن: https://payment.sepal.ir/api/v1
مسیرها همان شش مرحله است: payment/request/، payment/{paymentNumber}/، payment/{paymentNumber}/callback/، payment/verify/، payment/state/، payment/inquiry/
پس از ایجاد پرداخت، مرورگر را به GET /payment/{paymentNumber}/ هدایت کنید. صفحه درگاه آزمایشی با دکمهٔ پرداخت موفق و ناموفق باز میشود.
پس از انتخاب نتیجه، سندباکس پرداختکننده را به callbackUrl شما برمیگرداند. سپس Verify را از سرور خود صدا بزنید. alreadyVerified مثل پروداکشن عمل میکند.
در سندباکس هر apiKey غیرخالی پذیرفته میشود. بررسی IP، دامنه و ترمینال انجام نمیشود. اعتبارسنجی فیلدها (مبلغ حداقل، موبایل، فیلدهای اجباری) با پروداکشن یکسان است.
برای رفتن به پروداکشن فقط base_url را عوض کنید و apiKey واقعی درگاه را از پنل بگذارید. کالکشن Postman سندباکس: https://payment.sepal.ir/api/v1/docs/postman/sandbox-collection/
آیا این صفحه مفید بود؟