وب سرویس API نوین وان

API تبدیل شماره کارت به شماره حساب؛ دریافت خودکار شماره حساب مقصد برای کسب‌وکارها

API تبدیل شماره کارت به شماره حساب نوین وان یک وب‌سرویس REST است که با دریافت شماره ۱۶ رقمی کارت بانکی، شماره حساب متصل به آن، نام بانک صادرکننده و نام صاحب حساب را در کسری از ثانیه برمی‌گرداند. برخلاف سرویس‌های کارت‌به‌شبا که خروجی را در قالب شماره شبا تحویل می‌دهند، این وب‌سرویس مستقیماً شماره حساب بانکی را در همان قالبی که سامانه‌های مالی، حسابداری و core banking به آن نیاز دارند بازمی‌گرداند؛ بدون نیاز به تماس کاربر با بانک و بدون وارد کردن دستی اطلاعات توسط او.

  • تبدیل شماره کارت به شماره حساب
  • وب سرویس مناسب فین‌تک، درگاه‌های پرداخت و پلتفرم‌های تسویه
  • API استعلام مالک حساب بانکی
  • خروجی سازگار با سامانه‌های حسابداری و core banking
پاسخ سرویس 200 OK
{
  "success": true,
  "data": {
    "number": "6037123412341234",
    "bank": "بانک ملی",
    "type": "نقدی",
    "depositNumber": "030123456789"
  },
  "input": {
    "number": "6037123412341234"
  }
}
application/jsonNovin One API

REST APIمعماری استاندارد REST که با هر زبان برنامه‌نویسی و فریم‌ورکی سازگار است و امکان فراخوانی هم‌زمان از چند سرویس داخلی شما (پنل تسویه، سامانه حسابداری، درگاه پرداخت) را بدون تغییر در معماری فراهم می‌کند.

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

HTTPSانتقال شماره کارت و اطلاعات حساب در تمام مراحل از مسیر HTTPS و با رمزنگاری TLS انجام می‌شود تا داده‌های بانکی کاربران در مسیر انتقال محافظت شوند.

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

قیمت گذاری

قیمت API تبدیل شماره کارت به شماره حساب

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

برای اتصال سریع تر

کاربردهای API تبدیل شماره کارت به شماره حساب برای کسب‌وکارها

این سرویس برای جایگزینی فرآیندهایی طراحی شده که سیستم شما تنها شماره کارت کاربر را در اختیار دارد اما برای تسویه، حسابداری یا یکپارچه‌سازی با سامانه‌های بانکی به شماره حساب نیاز دارد.

01

تسویه با سامانه‌های حسابداری و core banking

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

02

بازگشت وجه (Refund) به حساب صحیح

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

03

تکمیل خودکار پروفایل مالی کاربر

در مراحل ثبت‌نام یا افزودن روش تسویه جدید، به‌جای درخواست شماره حساب از کاربر، تنها شماره کارت او دریافت و شماره حساب متناظر به‌صورت خودکار در پروفایل ثبت می‌شود.

برای تیم های محصول

صنایعی که از API تبدیل کارت به حساب نوین وان استفاده می‌کنند

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

گفتگو با تیم فروش

فین‌تک و کیف‌پول‌های دیجیتال

پیش از ثبت روش برداشت یا واریز کاربر، شماره حساب متصل به کارت او استخراج و در پروفایل ذخیره می‌شود تا نیازی به دریافت دستی شماره حساب از کاربر نباشد.

درگاه‌های پرداخت و پلتفرم‌های تسویه

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

شرکت‌های بیمه و اعتبارسنجی

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

تیم‌های محصول و ثبت‌نام آنلاین

تکمیل خودکار اطلاعات بانکی کاربر بدون نیاز به فرم‌های طولانی

برای توسعه‌دهنده‌ها

راهنمای اتصال به API تبدیل شماره کارت به شماره حساب

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

  1. 01در پنل سازمانی نوین وان ثبت‌نام کنید و اطلاعات کاربری خود را با اطلاعات شرکت تکمیل کنید.
  2. 02پس از تایید حساب کاربری، از پنل کاربری، کلید دسترسی (API Key) و توکن احراز هویت را دریافت کنید.
  3. 03با مراجعه به مستندات، endpoint تبدیل کارت به حساب را به محصول یا سامانه خود متصل کنید.
cURLPOST
curl --request GET 'https://api.novin.one/v1/cardsDeposit?number=6037123412341234' \
  --header 'Authorization: Bearer YOUR_ACCESS_TOKEN'
application/json — Novin One API
اتصال قابل‌اعتماد

امنیت و پایداری اتصال API تبدیل شماره کارت به شماره حساب

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

  • 01
    ارتباط رمزگذاری‌شدهدرخواست‌های حاوی شماره کارت و شماره حساب از مسیر HTTPS امن عبور می‌کنند.
  • 02
    دسترسی مبتنی بر توکنهر درخواست تبدیل نیازمند احراز هویت معتبر با API Key اختصاصی کسب‌وکار شماست.
  • 03
    کنترل مصرفگزارش تعداد تبدیل‌های انجام‌شده و هزینه‌های مربوطه برای شما در پنل کسب‌وکار قابل پیگیری است.
چرا نوین وان

چرا کسب‌وکارها API تبدیل کارت به حساب نوین وان را انتخاب می‌کنند؟

نوین وان علاوه بر ارائه وب‌سرویس‌های بانکی، زیرساختی برای اتصال سریع، پایدار و قابل توسعه در اختیار کسب‌وکارها قرار می‌دهد.

01

+5

سال تجربه کاری

02

76

مشتری فین‌تک بزرگ

03

+30

سرویس فعال

04

زمان پاسخ‌دهی کمتر از

1 تا 3 ثانیه

05

+20

منابع اصلی و بدون واسط

06

امکان سفارشی سازی

سرویسخاص با چند استعلام همزمان

سوالات متداول

سوالات متداول درباره API تبدیل شماره کارت به شماره حساب

آیا این سرویس برای استفاده مستقیم کاربران نهایی هم در دسترس است؟
خیر. این API صرفاً برای مصرف توسط سیستم‌های نرم‌افزاری کسب‌وکارهاست. کاربرانی که مقطعی و به‌صورت مستقیم نیاز به بررسی شماره حساب خود دارند، باید به نوین وان مراجعه کنند.
تفاوت این سرویس با API تبدیل کارت به شبا چیست؟
API تبدیل کارت به شبا، شماره شبای ۲۴ رقمی متصل به کارت را برمی‌گرداند و برای انتقال وجه پایا یا ساتنا کاربرد دارد. این سرویس اما شماره حساب بانکی را در همان قالبی که بانک صادرکننده تعریف کرده بازمی‌گرداند و برای سامانه‌هایی طراحی شده که شناسه ورودی موردنیازشان شماره حساب است، نه شبا.
آیا استفاده از این سرویس رایگان است؟
خیر. هزینه این سرویس بر اساس حجم تراکنش و به‌صورت مذاکره‌ای تعیین می‌شود. جزئیات نهایی از طریق ثبت تیکت با بخش مالی مشخص می‌شود.
در صورت نامعتبر بودن شماره کارت، آیا هزینه‌ای کسر می‌شود؟
بله. هر فراخوانی موفق سرویس، فارغ از نتیجه تبدیل، مشمول کارمزد استعلام است، چون اتصال به منبع رسمی داده در هر دو حالت انجام شده است.
آیا این سرویس تمام بانک‌های عضو شبکه شتاب را پوشش می‌دهد؟
بله. تبدیل برای کارت‌های صادرشده توسط تمام بانک‌های عضو شبکه بانکی کشور فعال است.
برای اتصال آماده‌اید؟

مسیر API محصولتان را از امروز یکپارچه کنید.

حساب سازمانی خود را بسازید و سرویس مناسب را از طریق مستندات نوین وان شروع کنید.