مستندات API تبدیل شماره کارت به شماره شبا و حساب
مستندات API تبدیل شماره کارت به شماره شبا و حساب | راهنمای کامل استفاده
در این صفحه میتوانید راهنمای کامل استفاده از API تبدیل شماره کارت به شماره شبا و حساب را مشاهده کنید. شامل پارامترهای ورودی، نمونه درخواست CURL، خروجی پاسخ، کدهای آماده و ویدئوی آموزشی برای درک بهتر عملکرد سرویس و استفاده آسان در پروژههای خود است. این مستندات به شما کمک میکند تا API را بهصورت دقیق و سریع پیادهسازی کنید و از تمام قابلیتهای سرویس بهرهمند شوید.
📝 توضیحات سرویس
دریافت اطلاعات کارت بانکی شامل: نام بانک، شماره شبا، شماره حساب، نام و نام خانوادگی صاحب کارت بانکی تمام بانکهای کشور.
🏷️ CURL
📡 POST api/v2/card_info
curl --location 'https://shabanic.ir/api/v2/card_info' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer {YOUR_SHABANIC_API_KEY}' \
--data '{
"cardNumber": "{YOUR_CARD_NUMBER}"
}'📌 ورودی های سرویس
🗂️ JSON Inputs
{
"cardNumber": "{YOUR_CARD_NUMBER}"
}📤 خروجی سرویس
🧾 JSON Response
{
"result": {
"iban": "IR680150000000392301102361",
"status": "ACTIVE",
"bankName": "SEPAH",
"cardType": "DEBIT",
"lastName": "زارعی",
"firstName": "علیرضا",
"depositNumber": "392301102011"
},
"message": null,
"success": true,
"trackId": "shabanic-699f494f204ae9.27478660",
"statusCode": 200
}
{
"success": false,
"error_code": "FN-BRFH-50000040816",
"message": "پیغام مرتبط با خطا",
"trackId": "shabanic-699dcc859daf40.50355751"
}
ℹ️ توضیحات سرویس تبدیل شماره کارت به شماره شبا و حساب
این سرویس برای تبدیل شماره کارت به شماره شبا و حساب استفاده میشود. در ادامه مشخصات کامل درخواست و پاسخ را مشاهده میکنید.
ورودیها (Parameters)
- cardNumber — شماره کارت بانکی
خروجیها (Response)
- trackId — شناسه یکتای پیگیری تراکنش
- message — پیام توضیحی سیستم (در صورت وجود)
- bankName — نام بانک صادرکننده کارت
- cardType — نوع کارت (نقدی/اعتباری/بن کارت و ...)
- depositNumber — شماره حساب متصل به کارت
- iban — شماره شبا مرتبط با حساب
- status — وضعیت فعال یا غیرفعال بودن کارت
- firstName — نام صاحب کارت
- lastName — نام خانوادگی صاحب کارت
- statusCode — کد وضعیت پاسخ HTTP
کاربرد های این 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❓ سوالات متداول (FAQ)
پاسخ به سوالات رایج در استفاده از سرویس تبدیل شماره کارت به شماره شبا و حساب.
این سرویس برای اپلیکیشنهای حملونقل، فروشگاههای اینترنتی، سیستمهای لجستیک، سامانههای ارسال مرسوله، پلتفرمهای نقشه و مسیریابی و همچنین سیستمهای تحلیل داده مکانی بسیار کاربردی است. با استفاده از این API میتوان موقعیت دقیق یک کد پستی را روی نقشه مشخص کرد.
این API برای اپلیکیشنهای بانکی، فینتکها، پلتفرمهای پرداخت آنلاین، کیف پولهای دیجیتال، سامانههای تسویهحساب فروشگاهها، سیستمهای پرداخت حقوق و مزایا، سایتهای فروشگاهی، خدمات اشتراک، نرمافزارهای حسابداری و ERP و هر کسبوکاری که نیاز به تبدیل سریع و دقیق شماره کارت به شماره شبا و اطلاعات حساب دارد بسیار کاربردی است. این سرویس به شما کمک میکند بدون خطای انسانی و بدون نیاز به محاسبات دستی، اطلاعات کامل حساب بانکی مشتری را استخراج کنید.
این API با دریافت شماره کارت بانکی (cardNumber) اطلاعاتی مانند نام بانک، نوع کارت، شماره حساب، شماره شبا (IBAN)، نام و نام خانوادگی صاحب حساب، وضعیت کارت و شناسه پیگیری (trackId) را به صورت JSON برمیگرداند.
استفاده از این API باعث کاهش خطای انسانی، افزایش سرعت در ثبت اطلاعات بانکی، بهبود تجربه کاربر، و اتوماسیون فرآیندهای مالی و پرداخت میشود؛ مخصوصاً زمانی که شماره شبا الزامی باشد در پرداختها یا دریافت وجه.
برای استفاده، یک درخواست POST به آدرس /api/v2/card_info با ارسال JSON که شامل cardNumber است، انجام دهید و در هدر درخواست، توکن شبانیک (Bearer Token) را قرار دهید تا پاسخ API را دریافت کنید.
ورودی: { "cardNumber": "شماره کارت 16 رقمی" } خروجی: شامل فیلدهای result.iban, result.bankName, result.depositNumber, result.firstName, result.lastName, result.cardType, result.status, success, trackId و statusCode است.
بله. این API اطلاعات کارت، شبا و حساب را برای اکثر بانکهای کشور بر اساس استانداردهای بانکی ایران فراهم میکند و نام بانک را هم در خروجی نمایش میدهد.
اگر شماره کارت واردشده نادرست باشد یا فرمت آن با 16 رقم مطابقت نداشته باشد، API پاسخ success=false برمیگرداند و میتوانید با بررسی پیام خطا در خروجی، کاربر را مطلع کنید.
بله. برای استفاده از API باید توکن شبانیک را دریافت کنید و آن را در هدر درخواست به صورت Bearer Token قرار دهید تا سرویس اجازه پردازش دادههای شما را بدهد.
با تبدیل کارت به شبا و دریافت اطلاعات حساب به صورت رسمی، میتوانید از پرداختهای معتبر، کاهش اشتباهات تراکنش و جلوگیری از تقلب در پرداختهای بانکی اطمینان حاصل کنید، زیرا شماره شبا یک شناسه معتبر و استاندارد بانکی است.
بله. این API برای اعتبارسنجی بانک مشتری، تکمیل اطلاعات حساب بانکی در فرمهای ثبتنام، و تضمین اینکه حساب واقعی است فوقالعاده مفید است، مخصوصاً زمانی که قصد دارید اطلاعات مالی را از طریق برنامه یا سایت جمعآوری کنید.
آمادهاید به سادهترین شکل ممکن، API «تبدیل شماره کارت به شماره شبا و حساب» را از شبانیک دریافت کنید؟
تنها در چند مرحله ساده، کلید اختصاصی API خود را دریافت کرده و سرویس تبدیل شماره کارت به شماره شبا و حساب را در پروژه خود فعال کنید.