استعلام و تبدیل بانک پاسارگاد
خدمتدهنده
بانک پاسارگاد
وب سرویس بانک پاسارگاد
مجموعه وب سرویسهای بانک پاسارگاد به شما این امکان را میدهد تا بخش زیادی از فرایندهای مرتبط با سپرده خود را که پیش از این از طریق شعبه و یا اینترنت بانک انجام می دادید
را بی واسطه و مستقیما، استفاده نمایید و در سیستمهای نرم افزاری خود پیاده سازی کنید. ابتدا با مراجعه به وب سایت www.podium.ir اقدام به ساخت کسب و کار نمایید
سپس براساس ماهیت حساب بانکی خود ، یکی از دو فرم حقیقی / یا حقوقی زیر را دانلود و بعد از کامل نموندن اطلاعات موردنیاز ، آن را به یکی از شعبه بانک پاسارگاد تحویل دهید .
دانلود فرم درخواست برای شخص حقیقی
دانلود فرم درخواست برای شخص حقوقی
در نظر داشته باشید :
سقف انتقال وجه دارای سقف حداکثر 100 میلیون تومان در هر روز، و 3 میلیارد تومان برای 30 روز است ، که حداکثر این مقدار را می توانید در فرم درخواست ، تعیین نمایید.
در صورت نیاز به انتقال وجه بیشتر از این مقدار ، باید از طریق شعبه ای که درخواست مشتری ثبت شده است برای این منظور اقدام شود.
انتقال وجه پایا
- مطابق قوانین بانک مرکزی، سقف مجاز انتقال وجه در هر تراکنش پایا مبلغ پانصد میلیون ریال است.
- انتقالات سامانهی "پایا" برای دستور پرداختهای مشتریان سه بار در روز و در روزهای غیر تعطیل رسمی و در سیکل ساعت 03:15 و 10:15 و 13:15 پردازش و برای اعمال نتیجه به بانکهای مقصد ارسال میشود.
دستور پرداختهای ثبت و تایید شده تا ساعت 13:15 در سیکل همان روز و دستور پرداختهای بعد از آن در سیکل روز بعد اعمال میگردد.همچنین در روزهای جمعه و سایر روزهای تعطیل رسمی یک چرخه پایا فعال و دستور پرداخت های ثبت شده تا ساعت 13:15 همان روز پردازش خواهند شد.
مشتری گرامی به اطلاع میرساند طبق بخشنامه بانک مرکزی از تاریخ: 99/10/01 بابت هر دستور پرداخت پایا به میزان 0.01 درصد مبلغ تراکنش با کف 2.000 ریال و سقف 25.000 ریال کارمزد از حساب شما کسر میگردد.
انتقال وجه پایای گروهی
انتقالات سامانهی "پایا" برای دستور پرداختهای مشتریان سه بار در روز و در روزهای غیر تعطیل رسمی و در سیکل ساعت 03:15 و 10:15 و 13:15 پردازش و برای اعمال نتیجه به بانکهای مقصد ارسال میشود. دستور پرداختهای ثبت و تایید شده تا ساعت 13:15 در سیکل همان روز و دستور پرداختهای بعد از آن در سیکل روز بعد اعمال میگردد.همچنین در روزهای جمعه و سایر روزهای تعطیل رسمی یک چرخه پایا فعال و دستور پرداخت های ثبت شده تا ساعت 13:15 همان روز پردازش خواهند شد.
مشتری گرامی به اطلاع میرساند طبق بخشنامه بانک مرکزی از تاریخ: 99/10/01 بابت هر واریز در دستور پرداخت گروهی پایا به میزان 1.000 ریال کارمزد از حساب شما کسر می گردد. همچنین قابل ذکر است دستور پرداخت گروهی به آن دسته از واریزهایی اطلاق می شود که تعداد واریزهای موجود در یک دستور پرداخت بیش از 10 واریز باشد و در واریزهای دسته ای کمتر از این تعداد، کارمزد بر اساس دستور پرداخت انفرادی محاسبه و اخذ خواهد شد.
انتقال وجه ساتنا
انتقالات سامانهی "ساتنا" در بانک مقصد، درصورتیکه تا ساعت 14:00 توسط مشتری ثبت و تایید گردد، تا پایان وقت اداری تاریخ موثر دستور پرداخت صورت گرفته و تعهد انجام دستور پرداخت در این سامانه بصورت "همان روز" است. جهت دستور پرداختهای ثبت و تایید شده پس از ساعت 14:00، در اولین روز کاری بعد به حساب مقصد ارسال خواهد شد.
مشتری گرامی به اطلاع میرساند طبق بخشنامه بانک مرکزی از تاریخ: 99/10/01 بابت هر دستور پرداخت ساتنا به میزان 0.02 درصد مبلغ تراکنش تا سقف 250.000 ریال کارمزد از حساب شما کسر می گردد.
انتقال وجه ساتنای گروهی
انتقالات سامانهی "ساتنا" در بانک مقصد، درصورتیکه تا ساعت 14:00 توسط مشتری ثبت و تایید گردد، تا پایان وقت اداری تاریخ موثر دستور پرداخت صورت گرفته و تعهد انجام دستور پرداخت در این سامانه بصورت "همان روز" است. جهت دستور پرداختهای ثبت و تایید شده پس از ساعت 14:00، در اولین روز کاری بعد به حساب مقصد ارسال خواهد شد.
مشتری گرامی به اطلاع میرساند طبق بخشنامه بانک مرکزی از تاریخ: 99/10/01 بابت هر واریز در دستور پرداخت گروهی ساتنا به میزان 0.02 درصد مبلغ تراکنش تا سقف 250.000 ریال کارمزد از حساب شما کسر میگردد.
ارسال دستور پرداختهای ساتنا از ساعت 14 و دستور پرداختهای پایا از ساعت 13:15 روز پنجشنبه مورخ 1400/09/18 به مقصد بانک سپه (قوامین سابق) میسر نبوده و هیچگونه پردازشی صورت نمیپذیرد.
منبع : وب سایت بانک پاسارگاد
پیش از شروع
پیش از هر اقدامی نیاز است که شما مطالب آغازین را در صفحه نقطه صفر مطالعه نمایید .
فراخوانی سرویس
ساختار عمومی یک درخواست HTTP و فراخوانی وب سرویس از 3 بخش "آدرس سرویس" ، "پارامترهای بخش Header" و "پارامترهای بخش Body " تشکیل میشود.
آدرس سرویس
درخواست ارسالی به وب سرویس بانک ، از متد POST و آدرس زیر جهت فراخوانی وب سرویسهای پادیوم استفاده میکند.
https://api.pod.ir/srv/sc/nzh/doServiceCall
بخش Header
بخش Header درخواست شامل پارامترهای زیر است :
- توکن ثابت کسب و کار _token_ : (با نامهای دیگر BusinessToken و یاApi Token ) که باید از پنل کسب وکار کسب وکار دریافت شود. و هویت استفاده کننده از سرویس توسط آن مشخص می شود (جهت دریافت این توکن مراجعه شودبه راهنمای آغاز به کار )
- نوع صادر کننده درخواست _tokenk_issuer_ : که همواره مقدار آن برابر با 1 می باشد.
- نوع محتوای درخواست HTTP فیلد Content_Type :که همواره برابر با مقدار application/x-www-form-urlencoded' می باشد
بخش BODY
بخش BODY درخواست شامل پارامترهای زیر است :
- scProductId : شناسه سرویس (محصول)
- scApiKey : کلید فراخوانی سرویس که برای هر سرویس متمامیز و یکتا می باشد. (نحوه ی دریافت آن در ادامه توضیح داده خواهد شد.)
- سایر پارامترها : که براساس نیاز سرویس در مستندات مربوط به سرویس آورده شده اند .
پاسخ سرویس
* بعد از فراخوانی وب سرویس در پادیوم ، پاسخ سرویس را به صورت یک متن با ساختار JSON دریافت خواهید کرد.
hasError : مقدار false نشان دهنده ی این است که فرایند ارسال درخواست و دریافت پاسخ از سرویس/سرویس دهنده با موفقیت انجام شده است. ( بدون درنظر گرفتن اینکه عملیات مربوط به وب سرویس چه نتیجه ای داشته است)
referenceNumber : شماره لاگ ثبت شده مربوط به درخواست و پاسخ است .باید توسط شما ذخیره شود تا امکان دستیابی به لاگ مربوط به درخواست و پاسخ وجود داشته باشد.
result : نتیجه فراخوانی سرویس می باشد.
result.result : اگر از سرویس های سایر سازمانها و تامین کنندگان که خارج از پلتفرم پاد هستند و سرویسهای آنها در بازارچه API پادیوم ثبت شده اند ، استفاده نمایید ، پاسخ نهایی آن سرویس را که میتواند به فرمت XML یا JSON باشد را در این فیلد دریافت خواهید کرد.
فعالسازی سرویس
نحوه ی ارسال درخواست فعالسازی سرویس ، و دریافت کلید فراخوانی سرویس ( _scApiKey_ ) :
برای استفاده از هر سرویس ابتدا باید درخواست فعالسازی آن سرویس را به پادیوم اعلام کنید.
بعد از بررسی و تایید آن درخواست ، توسط پادیوم ، باید کلید استفاده و فراخوانی از آن سرویس را دریافت نمایید.
فرایند ارسال درخواست و دریافت کلید( ApiKey ) به 2 روش امکان پذیر است. : ارسال درخواست با استفاده از سایت ، ارسال در خواست با استفاده از API
با استفاده از سایت
ارسال درخواست
ابتدا وارد سایت پادیوم شده ، سپس در بازارچه ی API ، سرویسهای موردنظر خود را انتخاب و درخواست استفاده از آن مجموعه سرویس را ارسال کنید .
دریافت کلیدفراخوانی سرویس
درخواست شما توسط کارشناسان پادیوم ، بررسی شده و بعد از تایید آن میتوانید از طریق پنل کسب وکار خود اقدام به دریافت کلید اتصال آن سرویس نمایید.
برای این منظور از پنل کسب وکار : منوی میزکار سرویس گیرنده – درخواستهای ارسالی ، https://panel.pod.ir/Businesses/RequestWebServices
در بخش مربوط به سرویس موردنظر با کلیک بر روی "جزئیات درخواست" – در لیست باز شده با کلیک بر روی تصویر کلید سمت چپ هر سطر جدول ، میتوانید Apikey مربوط به سرویس را دریافت و ذخیره کنید.
- این کلید در تمام درخواستهای ارسالی از آن سرویس ، ثابت است .
- این کلید در فیلد scApiKey در بخش body درخواست HTTP ، استفاده می شود.
دریافت لیست کلیدها در یک فایل :
بعد از فشردن دکمه ی تایید در پنجره ی باز شده صفحه ی قبل ، برای تمامی سرویسهای موجود در پنل ،
میتوانید از گزینه "دریافت فایل خروجی" ، لیست کاملی از سرویسها و کلیدهای scApikey متناظر با هریک را دریافت کنید.
با استفاده از سرویس
شما میتوانید سرویسها را از طریق فراخوانی سرویس ، درخواست دهید و کلید آن را دریافت کنید.
( همچنین میتوانید، Apikey سرویسهای فعلی خود را که در گذشته درخواست داده اید و تایید شده اند ، را نیز از طریق فراخوانی سرویس ، دریافت کنید، )
برای اینکار کافیست که:
1- ابتدا با استفاده از شناسه سرویس موردنظر ، استفاده از آن را درخواست داده ، و شناسه درخواست مربوط به آن سرویس را دریافت کنید.
* دقت شود که "شناسه درخواست" با "شناسه سرویس" متفاوت است.
* دقت شود که این درخواست باید توسط کارشناسان پادیوم تایید شود. بعد از درخواست به کارشناس مربوطه اطلاع دهید
2- سپس با استفاده از آن "شناسه درخواست" اقدام به دریافت کلید scApiKey ، مربوط به آن سرویس نمایید.
ارسال درخواست :
- _token_ : پارامتر Header که حاوی توکن ثابت کسب وکار (بیزنس توکن) است .
- _token_issuer_ : پارامتر Header که همواره حاوی مقدار ثابت 1 است .
- businessId : پارامتر Body که در اینجا همواره مقدار 1623 را خواهد داشت و این مقدار ثابت است .
- productId : پارامتر Body که حاوی شناسه سرویسی است که قصد ارسال "درخواست فعال سازی و استفاده" آن را دارید.
که در این مثال شناسه 55265 مربوط به سرویس استعلام قبوض است .
- depositNumber : حاوی شماره حساب بانک پاسارگاد به فرمت x.x.x.x متعلق به صادر کننده درخواست میباشد .
* ارسال این پارامتر تنها برای برخی سرویسهای بانکی از قبیل سرویسهای زیر الزامی است :
- لیست سپرده های مشتری با شناسه 1077447
- اطلاعات سپرده مشتری (تنها صاحب حساب) با شناسه 1077449
- صورتحساب تراکنش های سپرده با شناسه 1077467
- انتقال پایا (داخلی و خارجی ) با شناسه 1076566
- انتقال ساتنا ( فقط خارجی ) با شناسه 1077451
- انتقال وجه دسته ای ( فقط داخلی ) با شناسه 1077450
دریافت شناسه درخواست
حروجی سرویس ، به صورت JSON می باشد . که در آن شناسه ی درخواست متناظر با سرویس( در مثال بالا شناسه سرویس 55265 ) ، برابر با اولین id در فیلد result می باشد .
در این مثال ، شناسه ی درخواست 12721 می باشد.
دریافت کلید فراخوانی سرویس
بعد از اینکه درخواست شما توسط کارشناسان پادیوم تایید شد ، با استفاده از شناسه درخواست که در بخش قبل دریافت شده است در سرویس زیر ، اقدام به دریافت کلید scApikey مربوط به سرویس موردنظر خود نمایید
- _token_ : پارامتری در Header درخواست ، که حاوی توکن ثابت کسب وکار (Business Token) است .
- _token_issuer_ : پارامتری در Header درخواست ، که همواره حاوی مقدار ثابت 1 است .
- id : پارامتری در Body درخواست ، که شامل شناسه ی درخواست می باشد.
نتیجه این سرویس یک JSON است که اطلاعاتی در مورد کسب وکار و همینطور کلید apikey در آن وجود دارد.
مرجع کد / خطا
کد بانک
نام بانک (کد بانک) :
همه بانکها(-1) | بانک مرکزی (10) | پاسارگاد (57) | ایران زمین (69) |
ایران و ونزوئلا (95) | آینده (62) | پارسیان (54) | پست بانک (21) |
تجارت (18) | توسعه تعاون (22) | توسعه صادرات (20) | حکمت ایرانیان(65) |
خاورمیانه (78) | دی (66) | رسالت (70) | رفاه کارگران (13) |
سامان (56) | سپه (15) | سرمایه (58) | سینا (59) |
شهر (61) | صادرات (19) | صنعت و معدن (11) | قرض الحسنه مهر ایران (60) |
قوامین (52) | کارآفرین (53) | کشاورزی (16) | گردشگری (64) |
مسکن (14) | ملت (12) | ملی (17) | موسسه اعتباری توسعه (51) |
موسسه اعتباری کوثر(73) | موسسه اعتباری ملل(75) | موسسه اعتباری نور(80) | اقتصاد نوین (55) |
انصار(63) |
|
|
|
کد وضعیت چک
همه(0) - در راه (1) - نقد شده (2) - برگشتی (3) - بدون اقدام (4) - قابل استفاده (5) -
واگذار شده (6) - پرداخت قسمتی از چک (7) – مسدود (8) – باطل (9) – ثبت شده (10) –
رفع سوءاثر شده (11) – عودتی (12 ) – پرداخت شده (13 ) – مسدود /ثبت شده (14) – مسدود/بدون اقدام (15) –
مسدود/برگشتی(16) – خام (17 ) – وصول نشده (18) – عودت شده به مشتری (19) – صادرشده (20)
کد خطاهای بانکی
در این لینک میتوانید لیست خطاهای موجود در سرویسهای سپرده بانک پاسارگاد را دریافت نمایید .
استعلام شبا(چکیده اطلاعات) | ||
شناسه سرویس : 34254 با وارد کردن شماره شبا میتوانید اطلاعات اولیه ای چون نام / نام خانوادگی و فعال بودن این شماره شبا را بدست آورید. | ||
توضیحات | مقدار | نام پارامتر |
ورودی | ||
Header | ||
توکن ثابت کسب وکار، که از پنل کسب وکار قابل دریافت است | yourBusinessToken | _token_ |
این پارامتر همواره دارای مقدار ثابت 1 است . | 1 | _token_issuer_ |
این پارامتر نوع داده ارسالی به سرور را مشخص میکند که همواره باید دارای مقدار ثابت application/x-www-form-urlencoded' باشد | application/x-www-form-urlencoded | Content-Type |
Body | ||
شناسه سرویس | 34254 | scProductId |
این مقدار را بعد از درخواست سرویس و تایید پادیوم ، میتوانید از پنل یا از طریق api دریافت نمایید. | کلید فراخوانی سرویس | scApiKey |
شماره شبا به طول 26 کارکتر که در ابتدای آن IR قرار دارد. | IR123456789…. | sheba |
خروجی | ||
در صورت وقوع خطا در فراخوانی سرویس true خواهد بود | true/false | hasError |
جهت بررسی لاگ درخواست و ریسپانس توسط کارشناسان پادیوم ، استفاده میشود. | string | referenceNumber |
حاوی نتایج نهایی و پاسخ سرویس | jsonObject | result |
شماره شبای استعلام شده در درخواست | string | sheba |
اسامی صاحبان حساب | jsonArray | owners |
نام دارنده شبا | string | firstName |
نام خانوادگی دارنده شبا | string | lastName |
وضعیت فعال یاغیر فعال بودن شبا | true/false | block |
|
| hasWillBeBlock |
|
| accountStatus |
|
| accountStatusName |
نمونه درخواست | ||
bash | ||
نمونه پاسخ | ||
json |
استعلام شبا( اطلاعات کامل) | ||
شناسه سرویس : 1115396 با وارد کردن شماره شبا میتوانید اطلاعات کاملی چون نام / نام خانوادگی وشماره حساب ، کد و نام بانک ، فعال بودن این شماره شبا را بدست آورید | ||
توضیحات | مقدار | نام پارامتر |
ورودی | ||
Header | ||
توکن ثابت کسب وکار، که از پنل کسب وکار قابل دریافت است | yourBusinessToken | _token_ |
این پارامتر همواره دارای مقدار ثابت 1 است . | 1 | _token_issuer_ |
این پارامتر نوع داده ارسالی به سرور را مشخص میکند که همواره باید دارای مقدار ثابت application/x-www-form-urlencoded' باشد | application/x-www-form-urlencoded | Content-Type |
Body | ||
شناسه سرویس | 1115396 | scProductId |
این مقدار را بعد از درخواست سرویس و تایید پادیوم ، میتوانید از پنل یا از طریق api دریافت نمایید. | کلید فراخوانی سرویس | scApiKey |
یک JSON شامل پارامترهای موردنیاز با ساختار key:value | { "Iban":" IR890570…." } | request |
request | ||
شماره شبا به طول 26 کارکتر که در ابتدای آن IR قرار دارد. | IR123456789…. | Iban |
|
|
|
خروجی | ||
در صورت وقوع خطا در فراخوانی سرویس true خواهد بود | true/false | hasError |
جهت بررسی لاگ درخواست و ریسپانس توسط کارشناسان پادیوم ، استفاده میشود. | string | referenceNumber |
حاوی نتایج نهایی و پاسخ سرویس | jsonObject | result.result |
شماره شبای استعلام شده در درخواست | string | iban |
اسامی صاحبان حساب | jsonArray | ibanAccountOwnerList |
شماره حساب ، متعلق به شبا | string | accountNumber |
نام دارنده شبا | string | firstName |
نام خانوادگی دارنده شبا | string | lastName |
نام و کد بانک | jsonObject | bankInfo |
وضعیت فعال یاغیر فعال بودن شبا | true/false | accountStatus |
نمونه درخواست | ||
bash | ||
نمونه پاسخ | ||
json |
مقدار | نام پارامتر | |
yourBusinessToken | _token_ | |
1 | _token_issuer_ | |
application/x-www-form-urlencoded | Content-Type | |
34255 | scProductId | |
کلید فراخوانی سرویس | scApiKey | |
50222910……. | cardNumber | |
true/false | hasError | |
string | referenceNumber | |
string | result | |
تبدیل شماره کارت بانکی به شبا و سپرده | ||
شناسه سرویس : 1077466 به کمک این سرویس میتوانید شماره کارت بانک پاسارگاد را به شماره شبا و سپرده ی آن تبدیل نمایید. * توجه داشته باشید که تنها وارد کردن شماره کارت بانک پاسارگاد در این سرویس مجاز است . | ||
توضیحات | مقدار | نام پارامتر |
ورودی | ||
Header | ||
توکن ثابت کسب وکار، که از پنل کسب وکار قابل دریافت است | yourBusinessToken | _token_ |
این پارامتر همواره دارای مقدار ثابت 1 است . | 1 | _token_issuer_ |
این پارامتر نوع داده ارسالی به سرور را مشخص میکند که همواره باید دارای مقدار ثابت application/x-www-form-urlencoded' باشد | application/x-www-form-urlencoded | Content-Type |
Body | ||
شناسه سرویس | 1077466 | scProductId |
این مقدار را بعد از درخواست سرویس و تایید پادیوم ، میتوانید از پنل یا از طریق api دریافت نمایید. | کلید فراخوانی سرویس | scApiKey |
یک JSON شامل پارامترهای موردنیاز با ساختار key:value | {"CardNumber":"5022…….544"} | request |
request | ||
شماره 16 رقمی کارت بانکی، که بدون فاصله در این پارامترد ارسال می گردد. | 5022…….544 | CardNumber |
خروجی | ||
در صورت وقوع خطا در فراخوانی سرویس true خواهد بود | true/false | hasError |
جهت بررسی لاگ درخواست و ریسپانس توسط کارشناسان پادیوم ، استفاده میشود. | string | referenceNumber |
حاوی نتایج نهایی و پاسخ سرویس | jsonObject | result.result |
حاوی شماره حساب و شبا | jsonObject | ResultData |
شماره حساب بانک پاسارگاد | string | DepositNumber |
شماره شبای بانک پاسارگاد | string | Iban |
نمونه درخواست | ||
bash | ||
نمونه پاسخ | ||
json |
تبدیل شماره حساب به شبا | |||
شناسه سرویس : 1999892 از این سرویس جهت تبدیل شماره سپرده ی مشتری به شماره شبای آن استفاده می گردد. به نحوی که در ورودی، شماره سپرده دریافت شده و در خروجی، شماره ی شبا آن سپرده نمایش داده می شود. * نکته: این سرویس جهت دریافت اطلاعات سپرده ی اشخاص حقیقی و حقوقی ایرانی طراحی شده است و برای اتباع خارجی نمی توان از این سرویس استفاده کرد. | |||
توضیحات | مقدار | نام پارامتر | |
ورودی | |||
Header | |||
توکن ثابت کسب وکار، که از پنل کسب وکار قابل دریافت است | yourBusinessToken | _token_ | |
این پارامتر همواره دارای مقدار ثابت 1 است . | 1 | _token_issuer_ | |
این پارامتر نوع داده ارسالی به سرور را مشخص میکند که همواره باید دارای مقدار ثابت application/x-www-form-urlencoded' باشد | application/x-www-form-urlencoded | Content-Type | |
Body | |||
شناسه سرویس | 1999892 | scProductId | |
این مقدار را بعد از درخواست سرویس و تایید پادیوم ، میتوانید از پنل یا از طریق api دریافت نمایید. | کلید فراخوانی سرویس | scApiKey | |
یک JSON شامل پارامترهای موردنیاز با ساختار key:value | {"DepositNumber":"335.8000.123456.1"} | request | |
request | |||
شماره حساب مشتری در بانک پاسارگاد که با فرمت w.x.y.z وارد میشود. مانند 335.8000.123456.1 | string
| DepositNumber | |
| |||
خروجی | |||
در صورت وقوع خطا در فراخوانی سرویس true خواهد بود | true/false | hasError | |
جهت بررسی لاگ درخواست و ریسپانس توسط کارشناسان پادیوم ، استفاده میشود. توصیه می¬شود این پارامتر را برای هر درخواست ذخیره کنید. | string | referenceNumber | |
حاوی نتایج نهایی و پاسخ سرویس | jsonObject | result.result | |
موفق یا ناموفق بودن دریافت لیست سپرده ها | true/false | IsSuccess | |
شناسه یکتای تراکنش | string | UID | |
حاوی پاسخ نهایی سرویس | jsonObject | ResultData | |
ResultData | |||
شماره حساب مشتری در بانک پاسارگاد که با فرمت w.x.y.z وارد میشود. مانند 335.8000.123456.1 | string
| DepositNumber | |
شماره شبا | string | DepositIBAN | |
|
|
| |
| |||
نمونه درخواست | |||
Bash
| |||
نمونه پاسخ | |||
JSON
| |||
خطاهای معمول در پلتفرم | |||
کد خطا | توضیح | ||
21 | توکن کسبوکاری وارد نشده است | ||
227 | تایم اوت سرویس اصلی | ||
378 | ارسال پاسخ از سرویس اصلی به پلتفرم با مشکل مواجه شده است |
مقدار | نام پارامتر | |
yourBusinessToken | _token_ | |
1 | _token_issuer_ | |
application/x-www-form-urlencoded | Content-Type | |
1257838 | scProductId | |
کلید فراخوانی سرویس | scApiKey | |
w.x.y.z IR1233 | DepositNumber | |
0123456789 | NationalCode | |
true/false | hasError | |
string | referenceNumber | |
jsonObject | result.result | |
true/false | status | |
number | statusCode | |
string | message | |
تطابق کدملی و شماره سپرده/شبا
از این سرویس جهت کنترل صحت شماره شبا یا سپرده استفاده می شود. به نحوی که شماره شماره شبا/ سپرده و کد ملّی در ورودی دریافت میشود و درصورتی که شماره شبا یا سپرده متعلّق به کد ملّی دریافت شده باشد، نتیجه عملیات در خروجی نمایش داده میشود.
- شناسه سرویس: 1257838
- شناسه سرویس سندباکس: 168224
- پارامتر ورودی سرویس:
نام پارامتر | نوع | اختیاری / اجباری | توضیحات |
NationalId | Integer | اجباری | کد ملی |
DepositNumber | string | اجباری | شماره شبا/سپرده |
- پارامتر های خروجی:
نام پارامتر | نوع | توضیحات |
hasError | bool | نشان دهنده ی این است که آیا سرویس با موفقیت از روی پلتفرم پاد فراخوانی شده است یا خیر. |
messageId | int | پارامتر درون پلتفرمی ای که با توجه به این سرویس خاص موضوعیت ندارد. |
referenceNumber | string | شناسه ی درخواست در پلتفرم پاد. |
errorCode | int | کد ارور پلتفرمی. |
Count | int | پارامتر درون پلتفرمی ای که با توجه به این سرویس خاص موضوعیت ندارد. |
Ott | string | پارامتر درون پلتفرمی ای که با توجه به این سرویس خاص موضوعیت ندارد. |
Result | object | نتیجه ی فراخوانی سرویس در این آبجکت نمایش داده می شود که در ادامه شرح داده خواهد شد. |
نکته: طبق موارد مطرح شده، پاسخ مد نظر سرویس دریافت اطلاعات آدرس در فیلد result موجود است.
به صورت دقیق تر، بدنه ی پاسخ را میتوان در فیلد result مشاهده کرد که دارای ساختار زیر است:
- نمونه پاسخ سرویس موفق در Result:
- نمونه پاسخ سرویس نا موفق در Result:
- پارامتر های موجود در Result:
نام پارامتر | نوع | توضیحات |
Status | boolean | در صورت تطبیق داشتن مقدار true و در غیر اینصورت مقدار false برمی گردد |
statusCode | String | کد پاسخ طبق جدول زیر |
message | String | شرح برای کد نمایش داده می شود |
- پارامتر های موجود در statusCode:
نام کد | توضیحات |
1 | این شماره حساب متعلق به این کد ملی می باشد |
2 | این شماره حساب متعلق به این کد ملی نمی باشد |
3 | شماره حساب یافت نشد |
4 | خطا در فراخوانی سرویس (نمایش پاسخ علت خطا) |
255 | خطای ناشناخته |
کدهای خطای سرویس
کد خطا | عنوان | توضیحات |
1 | با موفقیت انجام شد | سرویس با موفقیت اجرا شده است |
0 | خطا | خطا در اجرای سرویس |
999 | خطای ناشناخته | لازم است سرویس مجدد فراخوانی گردد |
227 | عدم دریافت پاسخ از سرویس دهنده | لازم است سرویس مجدد فراخوانی گردد |
کد خطاهای بانکی
در این لینک میتوانید لیست خطاهای موجود در سرویسهای سپرده بانک پاسارگاد را دریافت نمایید .