مستندات API تطبیق کارت بانکی با کدملی

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

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

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

با این وب‌سرویس (API) با ارسال شماره کارت بانکی و کد ملی و تاریخ تولد، می‌توانید تطبیق مالکیت کارت بانکی را به‌صورت آنی و دقیق بررسی کنید — مناسب برای احراز هویت، جلوگیری از تقلب و تأیید تراکنش‌ها در سامانه‌های مالی و بانکی.

🏷️ CURL

📡 POST api/v2/card_owner_verification

curl --location 'https://shabanic.ir/api/v2/card_owner_verification' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer {YOUR_SHABANIC_TOKEN}' \
--data '{
  "cardNumber": "{YOUR_CARD_NUMBER}",
  "nationalCode": "{YOUR_NATIONAL_CODE}",
  "birthDate" : "{YOUR_BIRTHDAY=XXXX/XX/XX}"
}'

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

🗂️ JSON Inputs

{
    "birthDate": "{YOUR_BIRTHDAY=XXXX\/XX\/XX}",
    "cardNumber": "{YOUR_CARD_NUMBER",
    "nationalCode": "{YOUR_NATIONAL_CODE}"
}

📤 خروجی سرویس

🧾 JSON Response

{
    "result": {
        "isMatched": true
    },
    "message": null,
    "success": true,
    "trackId": "shabanic-699e1a8605bef0.96338404",
    "statusCode": 200
}

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

ℹ️ توضیحات سرویس تطبیق کارت بانکی با کدملی

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

ورودی‌ها (Parameters)

  • cardNumber — شماره کارت بانکی
  • nationalCode — کد ملی کاربر
  • birthDate — تاریخ تولد به صورت xxx/xx/xx
  • birthDate — تاریخ تولد

خروجی‌ها (Response)

کاربرد های این 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)

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

این سرویس برای اپلیکیشن‌های بانکی و فین‌تک، کیف‌پول‌های دیجیتال، سامانه‌های پرداخت آنلاین، فروشگاه‌های اینترنتی، سیستم‌های حقوق و دستمزد، نرم‌افزارهای حسابداری و ERP و هر کسب‌وکاری که نیاز به احراز هویت مالک کارت دارد مناسب است. با استفاده از این API می‌توان مالکیت کارت بانکی را با کد ملی و تاریخ تولد بررسی کرد و از تقلب و برداشت غیرمجاز جلوگیری نمود.

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

برای استفاده، یک درخواست POST به آدرس /api/v2/card_owner_verification ارسال کنید و در هدر درخواست توکن شبانیک (Bearer Token) را قرار دهید. ورودی JSON شامل cardNumber, nationalCode, birthDate است.

ورودی JSON: { "cardNumber": "شماره کارت 16 رقمی", "nationalCode": "کد ملی 10 رقمی", "birthDate": "YYYY/MM/DD" } خروجی JSON: شامل result.isMatched (true/false)، trackId، success و statusCode است.

در صورت عدم تطابق، مقدار result.isMatched=false بازگردانده می‌شود و می‌توانید از این اطلاعات برای جلوگیری از پرداخت‌های غیرمجاز یا ثبت نام‌های اشتباه استفاده کنید.

بله. برای استفاده از این سرویس باید توکن شبانیک را دریافت کنید و آن را به عنوان Bearer Token در هدر درخواست‌ها قرار دهید تا API پاسخ دهد.

با تطبیق کارت و کد ملی و بررسی فوری مالکیت کارت، می‌توان از تراکنش‌های تقلبی، برداشت غیرمجاز و اشتباهات انسانی جلوگیری کرد. همچنین باعث اتوماسیون و افزایش سرعت تراکنش‌ها می‌شود.

بله، API برای اکثر بانک‌های کشور قابل استفاده است و صحت مالکیت کارت را بر اساس اطلاعات رسمی بانکی بررسی می‌کند.

بله. این API برای ثبت‌نام کاربران، تایید تراکنش مالی و اعتبارسنجی حساب بانکی بسیار کاربردی است و به شما اطمینان می‌دهد که کارت متعلق به همان شخص است.

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

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

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

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