معرفی درگاه پرداخت باسلام

درگاه پرداخت باسلام به شما اجازه می‌دهد در اپلیکیشن یا پلاگین خود، پرداخت را به‌سادگی به جریان کاربر اضافه کنید — از خرید اشتراک گرفته تا پرداخت سفارش، شارژ کیف پول، یا هر تراکنش دیگری که نیاز به انتقال وجه از کاربر به غرفه‌دار دارد.

این مستند شما را از صفر تا یک پیاده‌سازی کامل و آماده‌ پروداکشن همراهی می‌کند: از دریافت کلید API تا اولین تراکنش موفق، فعال‌سازی اشتراک کاربر، و امن‌سازی پروداکشن.

این مستند برای چه کسی است؟

• توسعه‌دهنده‌ای که می‌خواهد در محصول خود (وب، موبایل یا داشبورد) پرداخت اضافه کند.
• صاحب اپ یا پلاگینی در اپ‌استور باسلام  که برای مونتاژ مدل کسب‌وکار خود به یک درگاه قابل اعتماد نیاز دارد.
• تیم‌هایی که قصد دارند سرویس داخلی خود را به اکوسیستم پرداخت باسلام متصل کنند.

پیش‌نیاز اصلی، آشنایی با HTTP و REST و یکی از زبان‌های Node.js، Python، PHP، Go یا C# است. نمونه‌های کد در همه‌ی این زبان‌ها در دسترس‌اند.

مسیر این مستند

این مستند یک مسیر منظم از مفهوم تا پروداکشن است. ترتیب پیشنهادی مطالعه:

1. شروع سریع — در ۵ دقیقه اولین پرداخت تستی را بزنید.
2. معماری و فلوی پرداخت — ببینید درگاه چطور کار می‌کند و اصطلاحات کلیدی (reference_id، hash_id، verify، inquiry) را یاد بگیرید.
3. راهنمای پیاده‌سازی — کد کامل سرویس و route ها در پنج زبان، گام‌به‌گام.
4. پیاده‌سازی Frontend — صفحات Checkout و Callback در React، Vue و Angular.
5. امنیت — چک‌لیست و بهترین شیوه‌های مخصوص درگاه پرداخت.
6. سوالات متداول — پاسخ‌های سریع به مشکلات رایج.

آنچه در پایان خواهید داشت

• یک سرویس پرداخت کامل با مدیریت تراکنش، Verify، و Idempotency
• اتصال امن به درگاه باسلام با احراز هویت X-Gateway-Secret کلید امنیتی
• صفحات Checkout و Callback آماده برای کاربر نهایی
• Reconciliation Job برای رسیدگی به تراکنش‌های معلق
• لاگ، مانیتورینگ، و Audit Trail متناسب با Production

کمک و پشتیبانی

• گروه پشتیبانی بله توسعه‌دهندگان 
• انجمن توسعه‌دهندگان باسلام