podium logo

استعلام و تبدیل بانک‌ها

خدمت‌دهنده

بازارچه پادیوم

فراخوانی آزمایشی BETAاطلاعات مجموعه سرویس

مقدمه

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

پیش از شروع

  • URL فراخوانی سرویس­ها:

Production Server: https://api.pod.ir/srv/sc/nzh/doServiceCall

Sandbox Server:https://sandbox.pod.ir/srv/sc/nzh/doServiceCall

  • تمامی درخواست­ها با متد POST ارسال می­شوند.
  • فیلدهای زیر درHeader تمامی درخواست­ها ثابت است:

پارامتر

توضیحات

_token_

توکن کسب­وکاری دریافتی از پنل

_token_issuer_

مقدار ثابت "1"
  • فیلدهای زیر در بدنه‌ی تمامی درخواست‌ها ثابت است (با فرمت x-www-form-urlencoded):

پارامتر

توضیحات

scProductId

شناسه­‌ی سرویس مدنظر

scApiKey

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

نکته:پس از درخواست سرویس به پادیوم، همکاران ما درخواستهای ارسالی را بررسی می‌کنند. در صورت عدم دریافت تایید کرد بر روی درخواست ارسالی ظرف یک روز کاری،به همکاران ما از طریق شماره تلفن (021-89518989) و یا در گروه واتس‌اپ اطلاع دهید تا دسترسی به سرویس موردنظر برای شما فعال شود.

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

سرویس دریافت شماره شبا از روی شماره حساب ( شبکه بانکی )

  • شناسه سرویس : 3374338

  • شناسه سرویس سندباکس: 163420

  • پارامتر ورودی سرویس

نام پارامتر

نوع

اختیاری / اجباری

توضیحات

deposit

Integer

اجباری

شماره حسابی که قصد دریافت شماره شبا آن را دارید

bankCode

Integer

اجباری

کد بانک مربوط به شماره حساب طبق جدول پیوست

نکته: این سرویس از حساب دیجیتال بانک پاسارگاد پشتیبانی میکند.

  • پارامتر های خروجی :

نام پارامتر

نوع

توضیحات

hasError

bool

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

messageId

int

پارامتر درون پلتفرمی ای که با توجه به این سرویس خاص موضوعیت ندارد.

referenceNumber

string

شناسه ی درخواست در پلتفرم پاد.

errorCode

int

کد ارور پلتفرمی.

Count

int

پارامتر درون پلتفرمی ای که با توجه به این سرویس خاص موضوعیت ندارد.

Ott

string

پارامتر درون پلتفرمی ای که با توجه به این سرویس خاص موضوعیت ندارد.

Result

object

نتیجه ی فراخوانی سرویس در این آبجکت نمایش داده می شود که در ادامه شرح داده خواهد شد.

نکته: طبق موارد مطرح شده، پاسخ مد نظر سرویس دریافت اطلاعات آدرس در فیلد result موجود است.

به صورت دقیق تر، بدنه ی پاسخ را میتوان در فیلد result مشاهده کرد که دارای ساختار زیر است:

  • پارامتر های پاسخ سرویس در Result :
json

 

deposit: شماره حساب

accountStatus:  میتواند مقادیر زیر را بگیرد

‌02: حساب فعال است

‌03: حساب مسدود با قابلیت واریز

‌04: حساب مسدود بدون قابلیت واریز

‌05: حساب راکد است

‌06: بروز خطادر پاسخ دهی, شرح خطا در فیلد توضیحات

bankName: نام بانک

iban: شماره شبا محاسبه شده

depositOwners: آرایه ای از صاحبان حساب

status: وضعیت فراخوانی سرویس

DONE:  فراخوانی موفق سرویس

FAILED: فراخوانی ناموفق سرویس

نمونه مقادیر پارامتر های سرویس سندباکس

  • نمونه موفقیت آمیز:

نام پارامتر

نوع

توضیحات

نمونه تستی

deposit

Integer

شماره حساب صحیح

0201363345600

bankCode

Integer

کد بانک اشتباه

053
json

 

 

  • نمونه خطا:

نام پارامتر

نوع

توضیحات

نمونه تستی

deposit

Integer

شماره حساب اشتباه

0201363345602

bankCode

Integer

کد بانک صحیح

053
json

 

  • کدهای خطای سرویس اصلی

کد خطا

عنوان

توضیحات

403

unauthorized scope

عدم دسترسی به اسکوپ یا توکن نامعتبر

400

VALIDATION_ERROR

عدم دسترسی به اسکوپ آدرس ارسالی

409

DUPLICATE_DATA

در صورتی که در سرویس تعریف مشتری،‌ مشتری ای دوباره تعریف شود
  • جدول شماره بانک های مروبط به پارامتر bankCode

#

نام بانک(به ترتیب حروف الفبا)

شماره کارت

کد بانک (bankCode)
  1.  

بانک اقتصاد نوين

627412

055
  1.  

بانک انصار

627381

063
  1.  

بانک ایران زمین

505785

069
  1.  

بانک ایران ونزوئلا

581874

095
  1.  

بانک آینده

636214

062
  1.  

بانک پارسيان

622106

054
  1.  

بانک پارسيان

627884

054
  1.  

بانک پارسيان

622106

054
  1.  

بانک پاسارگاد

502229

057
  1.  

بانک پاسارگاد

639347

057
  1.  

بانک تجارت

585983

018
  1.  

بانک تجارت

627353

018
  1.  

بانک توسعه تعاون

502908

022
  1.  

بانک توسعه صادرات

627648

020
  1.  

بانک توسعه صادرات

207177

020
  1.  

بانک حکمت ایرانیان

636949

065
  1.  

بانک خاورمیانه

585947

078
  1.  

بانک خاورمیانه

505809

078
  1.  

بانک دی

502938

066
  1.  

بانک رسالت

504172

070
  1.  

بانک رفاه

589463

013
  1.  

بانک سامان

621986

056
  1.  

بانک سپه

589210

015
  1.  

بانک سپه

604932

015
  1.  

بانک سرمايه

639607

058
  1.  

بانک سينا

639346

059
  1.  

بانک شهر

502806

061
  1.  

بانک شهر

504706

061
  1.  

بانک صادرات ايران

603769

019
  1.  

بانک صادرات ايران

903769

019
  1.  

بانک صنعت و معدن

627961

011
  1.  

بانک قرض الحسنه مهر

639370

060
  1.  

بانک قرض الحسنه مهر ایران

606373

060
  1.  

بانک قوامین

639599

052
  1.  

بانک کارآفرين

627488

053
  1.  

بانک کشاورزي

639217

016
  1.  

بانک کشاورزي

603770

016
  1.  

بانک گردشگری

505416

064
  1.  

بانک مرکزی 

636795

010
  1.  

بانک مسکن

628023

014
  1.  

بانک ملت

610433

012
  1.  

بانک ملت

991975

012
  1.  

بانک ملي ايران

603799

017
  1.  

بانک ملي ايران

170019

017
  1.  

پست بانک ايران

627760

021
  1.  

شبکه اکترونیکی پرداخت کارت

581672

093
  1.  

کبالت

999999

999
  1.  

موسسه اعتباری ملل

606256

075
  1.  

موسسه اعتباری نور

507677

080
  1.  

موسسه کوثر

505801

073
  1.  

موسسه مالي توسعه

628157

051

 

 

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

دریافت شماره حساب از شماره کارت

  • شناسه سرویس : 3374339

  • شناسه سرویس سندباکس: 163422

  • پارامتر ورودی سرویس:

نام پارامتر

نوع

اختیاری / اجباری

توضیحات

Card

String

اجباری

شماره کارت
  • پارامتر های خروجی :

نام پارامتر

نوع

توضیحات

hasError

bool

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

messageId

int

پارامتر درون پلتفرمی ای که با توجه به این سرویس خاص موضوعیت ندارد.

referenceNumber

string

شناسه ی درخواست در پلتفرم پاد.

errorCode

int

کد ارور پلتفرمی.

Count

int

پارامتر درون پلتفرمی ای که با توجه به این سرویس خاص موضوعیت ندارد.

Ott

string

پارامتر درون پلتفرمی ای که با توجه به این سرویس خاص موضوعیت ندارد.

Result

object

نتیجه ی فراخوانی سرویس در این آبجکت نمایش داده می شود که در ادامه شرح داده خواهد شد.

نکته: طبق موارد مطرح شده، پاسخ مد نظر سرویس دریافت اطلاعات آدرس در فیلد result موجود است.

به صورت دقیق تر، بدنه ی پاسخ را میتوان در فیلد result مشاهده کرد که دارای ساختار زیر است:

  • پارامتر های پاسخ سرویس در Result : 
json
  • result: آبجکتی از پاسخ سرویس شامل:
    • destCard شماره کارت وارد شده
    • name نام صاحب حساب
    • account: ‌ شماره حساب مربوط به شماره کارت وارد شده
    • result: نتیجه فراخوانی سرویس
    • description: توضیحات تکمیلی در مورد نتیجه
    • doTime: زمان انجام تراکنش
  • trackId: کد پیگیری است که با استفاده از آن میتوانید از سرویس‌های فینوتکی کارمزد را استعلام کنید.
  • status: وضعیت فراخوانی سرویس
    • DONE: فراخوانی موفق سرویس
    • FAILED: فراخوانی ناموفق سرویس
  • error: جزییات خطا (در صورت بروز خطا)

 

تبدیل کارت به شبا

این سرویس با دریافت شماره کارت ، اطلاعات شماره شبا را نمایش میدهد.

  • شناسه سرویس : 3374340

  • شناسه سرویس سندباکس: 163423

  • پارامتر ورودی سرویس:

نام پارامتر

نوع

اختیاری / اجباری

توضیحات

card

 string

اجباری

شماره کارت
  • پارامتر های خروجی :

نام پارامتر

نوع

توضیحات

hasError

bool

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

messageId

int

پارامتر درون پلتفرمی ای که با توجه به این سرویس خاص موضوعیت ندارد.

referenceNumber

string

شناسه ی درخواست در پلتفرم پاد.

errorCode

int

کد ارور پلتفرمی.

Count

int

پارامتر درون پلتفرمی ای که با توجه به این سرویس خاص موضوعیت ندارد.

Ott

string

پارامتر درون پلتفرمی ای که با توجه به این سرویس خاص موضوعیت ندارد.

Result

object

نتیجه ی فراخوانی سرویس در این آبجکت نمایش داده می شود که در ادامه شرح داده خواهد شد.

نکته: طبق موارد مطرح شده، پاسخ مد نظر سرویس دریافت اطلاعات آدرس در فیلد result موجود است.

به صورت دقیق تر، بدنه ی پاسخ را میتوان در فیلد result مشاهده کرد که دارای ساختار زیر است:

  • پارامتر های پاسخ سرویس در Result :
json
  • result: آبجکتی از پاسخ سرویس شامل:
    • IBAN: شماره شبا
    • bankName: نام بانک
    • deposit: شماره حساب
    • card: شماره کارت
    • depositStatus: میتواند مقادیر زیر را بگیرد
      • ‌02 : حساب فعال است
      • ‌03 : حساب مسدود با قابلیت واریز
      • ‌04 : حساب مسدود بدون قابلیت واریز
      • ‌05 : حساب راکد است
      • ‌06 : بروز خطادر پاسخ دهی , شرح خطا در فیلد توضیحات است
      • ‌07 : سایر موارد
    • depositOwners: صاحبان حساب
  • status: وضعیت فراخوانی سرویس
    • DONE: فراخوانی موفق سرویس
    • FAILED: فراخوانی ناموفق سرویس
  • error: جزییات خطا (در صورت بروز خطا)
  • trackId: ‌ کد پیگیری، اگر ارسال شده باشد همان مقدار و در غیر اینصورت یک رشته تصادفی تولید و برگردانده میشود

 

جدول شماره بانک‌های مربوط به پارامتر bankCode

#

نام بانک(به ترتیب حروف الفبا)

شماره کارت

کد بانک (bankCode)
  1.  

بانک اقتصاد نوين

627412

055
  1.  

بانک انصار

627381

063
  1.  

بانک ایران زمین

505785

069
  1.  

بانک ایران ونزوئلا

581874

095
  1.  

بانک آینده

636214

062
  1.  

بانک پارسيان

622106

054
  1.  

بانک پارسيان

627884

054
  1.  

بانک پارسيان

622106

054
  1.  

بانک پاسارگاد

502229

057
  1.  

بانک پاسارگاد

639347

057
  1.  

بانک تجارت

585983

018
  1.  

بانک تجارت

627353

018
  1.  

بانک توسعه تعاون

502908

022
  1.  

بانک توسعه صادرات

627648

020
  1.  

بانک توسعه صادرات

207177

020
  1.  

بانک حکمت ایرانیان

636949

065
  1.  

بانک خاورمیانه

585947

078
  1.  

بانک خاورمیانه

505809

078
  1.  

بانک دی

502938

066
  1.  

بانک رسالت

504172

070
  1.  

بانک رفاه

589463

013
  1.  

بانک سامان

621986

056
  1.  

بانک سپه

589210

015
  1.  

بانک سپه

604932

015
  1.  

بانک سرمايه

639607

058
  1.  

بانک سينا

639346

059
  1.  

بانک شهر

502806

061
  1.  

بانک شهر

504706

061
  1.  

بانک صادرات ايران

603769

019
  1.  

بانک صادرات ايران

903769

019
  1.  

بانک صنعت و معدن

627961

011
  1.  

بانک قرض الحسنه مهر

639370

060
  1.  

بانک قرض الحسنه مهر ایران

606373

060
  1.  

بانک قوامین

639599

052
  1.  

بانک کارآفرين

627488

053
  1.  

بانک کشاورزي

639217

016
  1.  

بانک کشاورزي

603770

016
  1.  

بانک گردشگری

505416

064
  1.  

بانک مرکزی 

636795

010
  1.  

بانک مسکن

628023

014
  1.  

بانک ملت

610433

012
  1.  

بانک ملت

991975

012
  1.  

بانک ملي ايران

603799

017
  1.  

بانک ملي ايران

170019

017
  1.  

پست بانک ايران

627760

021
  1.  

شبکه اکترونیکی پرداخت کارت

581672

093
  1.  

کبالت

999999

999
  1.  

موسسه اعتباری ملل

606256

075
  1.  

موسسه اعتباری نور

507677

080
  1.  

موسسه کوثر

505801

073
  1.  

موسسه مالي توسعه

628157

051

کدهای خطای سرویس اصلی

کد خطا

عنوان

توضیحات

403

unauthorized scope

عدم دسترسی به اسکوپ یا توکن نامعتبر

400

VALIDATION_ERROR

عدم دسترسی به اسکوپ آدرس ارسالی

409

DUPLICATE_DATA

در صورتی که در سرویس تعریف مشتری،‌ مشتری ای دوباره تعریف شود
Clasor npm package version 2.1.4
به پادیوم قدرت داده اند:
pasargad
fanap
pod