مستندات API دریافت اطلاعات حساب های بانکی

مستندات API دریافت اطلاعات حساب های بانکی | راهنمای کامل استفاده

در این صفحه می‌توانید راهنمای کامل استفاده از API دریافت اطلاعات حساب های بانکی را مشاهده کنید. شامل پارامترهای ورودی، نمونه درخواست CURL، خروجی پاسخ، کدهای آماده و ویدئوی آموزشی برای درک بهتر عملکرد سرویس و استفاده آسان در پروژه‌های خود است. این مستندات به شما کمک می‌کند تا API را به‌صورت دقیق و سریع پیاده‌سازی کنید و از تمام قابلیت‌های سرویس بهره‌مند شوید.

📝 توضیحات سرویس

با استفاده از این وب سرویس می توانید اطلاعات شماره حساب بانکی شامل نام بانک، شماره شبا، نام و نام خانوادگی صاحب حساب و وضعیت حساب را در کوتاه ترین زمان ممکن از شبانیک اخذ نمایید، این سرویس اطلاعات حساب تمامی بانک های کشور را ارائه می دهد.

🏷️ CURL

📡 POST api/v2/deposit_info

curl --location 'https://shabanic.ir/api/v2/deposit_info' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer {YOUR_SHABANIC_API_KEY}' \
--data '{
    "deposit": "{YOUR_DEPOSIT_NUMBER}",
    "bankCode":"{YOUR_BANK_CODE}"
}'

📌 ورودی های سرویس

🗂️ JSON Inputs

{
    "deposit": "{YOUR_DEPOSIT_NUMBER}",
    "bankCode":"{YOUR_BANK_CODE}"
}

📤 خروجی سرویس

🧾 JSON Response

{
    "success": true,
    "status": "DONE",
    "trackId": "shabanic-69cb73640ffa56.32680039",
    "result": {
        "deposit": "0343294195009",
        "accountStatus": "02",
        "bankName": "بانک ملی",
        "iban": "IR040170000000343294195009",
        "depositOwners": "علیرضا خرسند"
    }
}

{
	"success": false,
	"error_code": "FN-BRFH-50000040816",
	"message": "پیغام مرتبط با خطا",
	"trackId": "shabanic-699dcc859daf40.50355751"
}
برای پیگیری خطا کافیست مقدار trackId را به پشتیبانی شبانیک بدهید.

ℹ️ توضیحات سرویس دریافت اطلاعات حساب های بانکی

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

ورودی‌ها (Parameters)

  • deposit — شماره حساب
  • bankCode — کد بانک (جدول کد بانک ها را در فایل پیوست کد ها از قسمت پایین دانلود نمایید)

خروجی‌ها (Response)

  • success — وضعیت کلی پاسخ
  • status — وضعیت درخواست
  • trackId — کد یکتا بابت پیگیری درخواست از پشتیبانی شبانیک
  • deposit — شماره حساب مندرج در بانک
  • accountStatus — وضعیت حساب (02 حساب فعال است. 03 حساب مسدود با قابلیت واریز است. 04 حساب مسدود بدون قابلیت واریز است. 05 حساب راکد است. 06 بروز خطادر پاسخ دهی؛ شرح خطا در فیلد توضیحات است. 07 سایر موارد )
  • bankName — نام بانک
  • iban — شماره شبای متناظر با حساب
  • depositOwners — مشخصات دارندگان حساب

کاربرد های این Api

  • تبدیل حساب به شبا —تبدیل کردن شماره حساب تمامی بانک ها به شماره شبا
  • اطلاعات حساب —اخذ اطلاعات کلیه حساب های بانکی تمامی بانکها
  • اطلاعات دارنده حساب —اخذ اطلاعات مربوط به دارنده یا دارندگان حساب

نکات مهم

  • فعال‌سازی API شبانیک — برای شروع استفاده از APIهای شبانیک، ابتدا پروفایل خود را تکمیل کنید (مشاهده پروفایل) و سپس با پشتیبانی مستقیم شبانیک (09156012679) برای صدور مجوز و دریافت توکن اقدام نمایید.
  • توکن شبانیک — پس از دریافت مجوز، توکن خود را به‌عنوان Bearer در هدر درخواست‌ها قرار دهید.

🎬 ویدئوی آموزشی API دریافت اطلاعات حساب های بانکی

در این ویدئو نحوه فراخوانی API دریافت اطلاعات حساب های بانکی از سامانه شبانیک توضیح داده شده است.

💻 دانلود نمونه کدهای API دریافت اطلاعات حساب های بانکی

در این بخش می‌توانید نمونه کدهای آماده برای فراخوانی API دریافت اطلاعات حساب های بانکی شبانیک به زبان‌های PHP (Laravel)، JavaScript (Node.js)، Python، Java، Kotlin، C# (.NET) و cURL را دانلود کرده و مستقیماً در پروژه خود استفاده کنید.

نمونه کد PHP (Laravel) برای فراخوانی API دریافت اطلاعات حساب های بانکی

دانلود فایل PHP

نمونه کد JavaScript (Node.js) برای استفاده از API دریافت اطلاعات حساب های بانکی

دانلود فایل JavaScript

نمونه کد Python برای اتصال به API دریافت اطلاعات حساب های بانکی شبانیک

دانلود فایل Python

نمونه کد Java (اندروید) برای فراخوانی API دریافت اطلاعات حساب های بانکی

دانلود فایل Java

نمونه کد Kotlin برای استفاده از API دریافت اطلاعات حساب های بانکی در اپلیکیشن موبایل

دانلود فایل Kotlin

نمونه کد C# (.NET) برای اتصال به API دریافت اطلاعات حساب های بانکی

دانلود فایل C#

نمونه درخواست cURL برای تست API دریافت اطلاعات حساب های بانکی

دانلود فایل cURL
دانلود همه نمونه کدهای API این سرویس به صورت (ZIP)

❓ سوالات متداول (FAQ)

پاسخ به سوالات رایج در استفاده از سرویس دریافت اطلاعات حساب های بانکی.

آماده‌اید به ساده‌ترین شکل ممکن، API «دریافت اطلاعات حساب های بانکی» را از شبانیک دریافت کنید؟

تنها در چند مرحله ساده، کلید اختصاصی API خود را دریافت کرده و سرویس دریافت اطلاعات حساب های بانکی را در پروژه خود فعال کنید.

رفتن به پنل توسعه‌دهندگان
Shabanic Postman