زیرساخت پرداخت اپاستور باسلام منتشر شد!
با افتخار اعلام میکنیم که درگاه پرداخت باسلام از امروز در دسترس توسعهدهندگان قرار گرفته است.
این درگاه به شما امکان میدهد پرداخت را مستقیماً داخل اپلیکیشن، پلاگین یا سرویس خود پیادهسازی کنید؛ از فروش پلن و پرداخت سفارش گرفته تا هر سناریوی مالی دیگری که نیاز به دریافت پرداخت، فروش اشتراک یا مدیریت تراکنش دارد.
مستندات کامل درگاه پرداخت با ساختار جدید، راهنمای مرحلهبهمرحله، نمونهکدهای بکاند و مثالهای فرانتاند منتشر شده است. مشاهده مستندات →
چرا درگاه پرداخت باسلام؟
پیادهسازی پرداخت در بسیاری از سرویسها معمولاً با چالشهایی مثل احراز هویت جداگانه، تنظیمات پیچیده، تفاوت APIها و فرایندهای زمانبر فعالسازی همراه است.
درگاه پرداخت باسلام تلاش میکند این تجربه را برای توسعهدهندگان سادهتر و یکپارچهتر کند:
- یک API یکپارچه برای مدیریت تراکنشهای مالی در اکوسیستم باسلام
- فعالسازی سریع بدون فرایندهای پیچیدهی رایج
- احراز هویت ساده با هدر
X-Gateway-Secret(کلید امنیتی) - مستندات Production-Ready همراه با نمونهکد و معماری پیشنهادی
- پشتیبانی از جریان کامل تراکنش شامل Verify، Inquiry و مدیریت وضعیتها
راهاندازی در چند دقیقه
اگر میخواهید سریع شروع کنید، در راهنمای شروع سریع میتوانید تنها با چند خط کد در Node.js یا Python اولین تراکنش تستی خود را ایجاد کنید.
فراتر از یک درگاه پرداخت
درگاه پرداخت باسلام فقط برای دریافت پول نیست؛ مجموعهای از قابلیتهای مالی و زیرساختی است که به شما کمک میکند سریعتر محصول بسازید و راحتتر درآمدزایی کنید.
با استفاده از درگاه پرداخت باسلام میتوانید:
- فروش پلن و اشتراک با تمدید خودکار راهاندازی کنید
- از روشهای پرداخت متنوع مثل کیف پول باسلام، تراز غرفه و کارت بانکی استفاده کنید
- درآمد از فروش در لحظه به اعتبار کیف پول باسلامی شما واریز میشود و هر زمان قابل برداشت است
- بدون ساخت سیستم Billing جداگانه، تخفیف، کوپن و مدیریت اشتراک را پیادهسازی کنید
- به زیرساخت مالی و کاربران اکوسیستم باسلام متصل شوید
برای آشنایی بیشتر با قابلیتها و سناریوهای استفاده، صفحه معرفی درگاه پرداخت را ببینید.
فلوی پرداخت
فرآیند پرداخت از زمان کلیک کاربر تا نهایی شدن تراکنش، شامل چهار مرحله است:
- Initiate — یک
reference_idیکتا تولید میکنید، تراکنش را باstatus='pending'در دیتابیس ذخیره میکنید و باPOST /pay/transactions، لینک پرداخت (pay_url) دریافت میکنید. - Redirect — کاربر را به
pay_urlهدایت میکنید. - Callback — پس از پرداخت، کاربر با
hash_id،reference_idوstatusبهcallback_urlشما بازگردانده میشود. - Verify — با
POST /pay/transactions/{hash_id}/verifyتراکنش را نهایی و معتبر میکنید.
مرحلهی Verify الزامی است. اگر تراکنش Verify نشود، در وضعیت معلق باقی میماند و پس از مدتی بهصورت خودکار Refund خواهد شد.
برای مشاهدهی دیاگرام کامل فلو، وضعیتهای تراکنش و توضیح مفاهیمی مثل reference_id، hash_id، verify و inquiry به صفحهی معماری و فلوی پرداخت مراجعه کنید.
قبل از شروع
پیش از پیادهسازی، این موارد را آماده کنید:
- احراز هویت توسعهدهنده را در پنل توسعهدهندگان تکمیل کنید.
- از طریق بخش هسته مالی درخواست درگاه داده و کلید امنیتی درگاه را دریافت کنید.
سپس میتوانید بسته به نیازتان یکی از این مسیرها را انتخاب کنید:
- شروع سریع: مستقیماً به سند شروع سریع بروید.
- پیادهسازی کامل و Production-Ready: مسیر مستندات را از معرفی بهترتیب دنبال کنید.
در پایان چه خواهید داشت؟
با دنبال کردن مستندات و استفاده و پیادهسازی درگاه پرداخت اپاستور باسلام، یک زیرساخت پرداخت کامل خواهید داشت که شامل:
- مدیریت کامل چرخه تراکنش
- Verify و Idempotency استاندارد
- صفحه روش پرداختهای متنوع: کیف پول، تراز غرفه، کارت بانکی
- مدیریت پلنهای فروش اپ و پیادهسازی تخفیف، کوپن، تمدید خودکار و ...
پشتیبانی
برای سوالات فنی، گزارش باگ یا دریافت راهنمایی:
سخن پایانی
درگاه پرداخت باسلام حاصل همکاری تیمهای OpenAPI و مالی باسلام برای سادهتر کردن تجربهی پیادهسازی پرداخت در محصولات توسعهدهندگان است.
تلاش کردهایم مستنداتی ارائه کنیم که هم برای شروع سریع مناسب باشد و هم نیازهای یک پیادهسازی پروداکشن را پوشش دهد.
اگر در مسیر توسعه به نکتهای رسیدید که میتواند مستندات را بهتر کند، خوشحال میشویم بازخوردتان را با ما در میان بگذارید.
تیم اپاستور باسلام