معماری و فلوی پرداخت

معماری و جریان پرداخت

درگاه پرداخت باسلام از معماری پیش‌تراکنش استفاده می‌کند که امنیت و کنترل بالایی را فراهم می‌آورد.

ایجاد سفارش در سرور شما

کاربر سفارش خود را ثبت می‌کند

ایجاد پیش‌تراکنش

Server-to-Server

POST /v1/pay/pre-transactions

← دریافت hash_id و pay_url

ریدایرکت به صفحه پرداخت

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

انتخاب روش پرداخت

walletbalanceonline

پردازش پرداخت

wallet/balance: تکمیل فوری

online: ریدایرکت به درگاه بانک

بازگشت به سایت شما

ریدایرکت به callback_url

?status=unverified&hash_id=abc123xyz

استعلام وضعیت نهایی

Server-to-Server

POST /v1/pay/transactions/{hash_id}/verify

successunverifiedfailed

امنیت: تمام عملیات حساس (ایجاد و استعلام) از سرور شما انجام می‌شود
Idempotency: reference_id باید یکتا باشد تا از تراکنش‌های تکراری جلوگیری شود
انقضا: پیش‌تراکنش‌ها زمان انقضا دارند (معمولاً 30 دقیقه)
Stateless: هر استعلام وضعیت لحظه‌ای را از سیستم می‌گیرد

تمام درخواست‌های سرور به سرور نیاز به هدر احراز هویت دارند:


X-Gateway-Secret: your_gateway_secret_here
Content-Type: application/json