سوالات متداول

پیش‌تراکنش امنیت بالایی دارد چون:

• تمام عملیات حساس از سرور شما انجام می‌شود
• کاربر نمی‌تواند مبلغ یا اطلاعات را دستکاری کند
• شما کنترل کامل روی جریان پرداخت دارید

پیشنهاد: هر ۵ دقیقه یک‌بار

• کمتر از ۵ دقیقه: فشار زیاد به سرور
• بیشتر از ۵ دقیقه: تاخیر در تایید پرداخت

همچنین از Exponential Backoff استفاده کنید:

• اولین چک: ۵ دقیقه بعد
• دومین چک: ۱۰ دقیقه بعد
• سومین چک: ۲۰ دقیقه بعد
• و به همین ترتیب

خیر، هرگز!

پارامترهای URL قابل دستکاری هستند. حتماً:

1. hash_id را از URL بگیرید
2. با API استعلام بزنید
3. به وضعیت دریافتی از API اعتماد کنید

خیر. API فقط ریال قبول می‌کند.

اگر در سیستم خود با تومان کار می‌کنید، قبل از ارسال به API ضرب در ۱۰ کنید:

amount_toman = 50000
amount_rial = amount_toman * 10  # 500000

پیش‌تراکنش‌ها به صورت خودکار منقضی می‌شوند (معمولاً 30 دقیقه).

اگر می‌خواهید قبل از انقضا لغو کنید:

• در دیتابیس خود وضعیت را به cancelled تغییر دهید
• دیگر به کاربر لینک پرداخت ندهید

نکته: پیش‌تراکنش‌های منقضی شده قابل استفاده نیستند و خطای 410 Gone برمی‌گردانند.

خیر. reference_id باید یکتا باشد.

اگر دوباره با همان reference_id درخواست بزنید، خطای 409 Conflict دریافت می‌کنید.

راه‌حل: از ترکیب order_id + timestamp استفاده کنید:

reference_id = f"ORDER-{order_id}-{int(time.time())}"

بله، کاربر در صفحه پرداخت می‌تواند از روش‌های مختلف استفاده کند:

• کیف پول باسلام
• تراز غرفه (برای فروشندگان)
• پرداخت آنلاین (کارت بانکی)

شما نیازی به مدیریت این موارد ندارید — سیستم باسلام خودکار مدیریت می‌کند.