گزارش و اطلاعات سپرده
خدمت‌دهنده
بانک پاسارگاد
وب سرویس بانک پاسارگاد
مجموعه وب سرویسهای بانک پاسارگاد به شما این امکان را میدهد تا بخش زیادی از فرایندهای مرتبط با سپرده خود را که پیش از این از طریق شعبه و یا اینترنت بانک انجام می دادید
را بی واسطه و مستقیما، استفاده نمایید و در سیستمهای نرم افزاری خود پیاده سازی کنید. ابتدا با مراجعه به وب سایت 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 به مقصد بانک سپه (قوامین سابق) میسر نبوده و هیچگونه پردازشی صورت نمی‌پذیرد.
منبع : وب سایت بانک پاسارگاد
درخواست استفاده از سرویسهای مبتنی بر حساب بانک پاسارگاد متعلق به مشتری:
نحوه‌ی ارسال درخواست فعالسازی سرویس ، و دریافت کلید فراخوانی سرویس ( _scApiKey_ ):
برای استفاده از هر سرویس ابتدا باید درخواست فعالسازی آن سرویس را به پادیوم اعلام کنید.
بعد از بررسی و تایید آن درخواست ، توسط پادیوم ، باید کلید استفاده و فراخوانی از آن سرویس را دریافت نمایید.
برای استفاده از هر سرویس یک کلید فراخوانی باید دریافت شود. :
❖ نکته: این کلید در تمام درخواستهای ارسالی از آن سرویس، ثابت بوده و نیاز نیست برای هر بار فراخوانی سرویس، کلید جدید دریافت نمایید.
دربافت APIKey از طریق سرویس:
شما میتوانید "کلید فراخوانی" سرویسهای مورد نظر خود را از طربق فراخوانی سرویس 1384158 ، درخواست دهید و یا کلید آن را دریافت نمایید.
شما از طریق این سرویس میتوانید، لیستی از شناسه های سرویس و لیستی از شماره حسابهای خود را که قصد استفاده از آنها را دارید ارسال نمایید.
این سرویس دارای سه پارامتر می باشد:
| پارامتر | توضیحات | اجباری/اختیاری |
| scProductId | شناسه سرویس (1384158) | اجباری |
| serviceNumbers | یک یا لیستی از شماره سرویسهای مورد درخواست ، که داخل براکت [] می آیند و میتوانند بوسیله (کاما) از یکدیگر جدا شوند | اجباری |
| Deposits | یک یا لیستی از شماره حسابهای بانک پاسارگاد مشتری که در نیاز سرویس میتواند داخل [] ارسال و با(کاما) از یکدیگر جدا شوند. | اختیاری |
به عنوان مثال، در درخواست زیر برای سرویسهای استعلام شبا 34254 و استعلام کارت 34255 درخواست استفاده از سرویس ارسال میشود.
نمونه خروجی
❖ متناسب با وضعیت پارامتر statusCode به شما پیغام مناسب داده خواهد شد:
| پارامتر statusCode | توضیحات |
| scApiKey_REQUESTED | درخواست استفاده از سرویس ارسال شده است و در مرحله بررسی و تایید توسط پادیوم است . می توانید با استفاده از شناسه درخواست requestId و شناسه بیزنس businessId خود ، از پادیوم پیگیری نمایید. |
| scApiKey_GENERATED | کلید فراخوانی ایجاد شده است ، و میتوانید از کلید تولید شده در فیلد مورد نظر scApiKey استفاده نمایید. توجه نمایید که کلید تولید شده ی قبلی منقضی میشود . |
| REQUEST_FAILED | اگر درخواست با خطا مواجه شود این وضعیت ایجاد میشود ، به عنوان مثال ممکن است شما سرویسی را درخواست داده باشید ، که نیازمند شماره حساب بانکی باشد ، ولی شماره حسابی را جهت استفاده ، به پادیوم اعلام نکرده باشید و پیغام "برای استفاده از این سرویس نیاز به شماره حساب دارید" دریافت کنید. |
❖ بعداز تایید ، میتوانید مجدد این سرویس را برای بدست آوردن کلید scApiKey فراخوانی کنید.
اگر سرویس درخواستی شما جزء سرویس هایی است که برای استفاده نیاز به شماره حساب دارد:
1. اگر قبلا یک یا چند، شماره حساب شما ، توسط پادیوم ثبت شده باشد:
تنها با ارسال شناسه ی سرویس ، میتوانید برای تمامی شماره حسابهای ثبت شده خود ، کلید فراخوانی سرویس scApiKey دریافت نمایید.
نمونه درخواست
2. اگر قبلا یک یا چند شماره حساب شما, توسط پادیوم ثبت شده باشد و تنها نیاز داشته باشید که برای استفاده یک یا برخی از آنها کلید فراخوانی سرویس دریافت نمایید,
کافیست لیستی از شماره حسابهای بانک پاسارگاد خود (اعلام شده در فرم بانکی) را وارد نمائید.
نمونه درخواست
فعالسازی سرویس
نحوه ی ارسال درخواست فعالسازی سرویس ، و دریافت کلید فراخوانی سرویس ( _scApiKey_ ) :
برای استفاده از هر سرویس ابتدا باید درخواست فعالسازی آن سرویس را به پادیوم اعلام کنید.
بعد از بررسی و تایید آن درخواست ، توسط پادیوم ، باید کلید استفاده و فراخوانی از آن سرویس را دریافت نمایید.
فرایند ارسال درخواست و دریافت کلید( ApiKey ) برای سرویسهای بانکی به یک روش امکان پذیر است. : ارسال در خواست با استفاده از API
با استفاده از سرویس
شما میتوانید سرویسها را از طریق فراخوانی سرویس ، درخواست دهید و کلید آن را دریافت کنید.
(همچنین میتوانید، 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_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: عودت شده به مشتری |
| 21: صادر شده |
|
|
|
|
موجودی سپرده مشتری
شناسه سرویس: 1337328
از این سرویس جهت استعلام موجودی سپرده ی مشتری استفاده می گردد. به نحوی که در ورودی، شماره سپرده دریافت شده و در خروجی، موجودی سپرده مشتری نمایش داده می شود.
* نکته: این سرویس جهت دریافت اطلاعات سپرده ی اشخاص حقیقی و حقوقی ایرانی طراحی شده است و برای اتباع خارجی نمی توان از این سرویس استفاده کرد.
| توضیحات | مقدار | نام پارامتر | |
| ورودی | |||
| Header | |||
| توکن ثابت کسب وکار، که از پنل کسب وکار قابل دریافت است | yourBusinessToken | _token_ | |
| این پارامتر همواره دارای مقدار ثابت 1 است . | 1 | _token_issuer_ | |
| این پارامتر نوع داده ارسالی به سرور را مشخص میکند که همواره باید دارای مقدار ثابت application/x-www-form-urlencoded' باشد | application/x-www-form-urlencoded | Content-Type | |
| Body | |||
| شناسه سرویس | 1337328 | 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 | |
| مانده سپرده | int | DepositBalance | |
| ماندهی قابل برداشت | int | DepositAvailableBalance | |
| نمونه درخواست | |||
| bash | |||
| نمونه پاسخ | |||
| json | |||
لیست سپرده های مشتری
شناسه سرویس: 1077447
از این سرویس جهت دریافت لیست سپرده های مشتری استفاده میشود. به نحوی که با دریافت شماره ی مشتری یا کد ملی/شناسه ی ملی در ورودی، نتیجه ی عملیات به همراه لیست سپرده های مشتری شامل (شماره حساب، شماره شبا، نوع حساب، تاریخ افتتاح و...) در خروجی نمایش داده میشود.
نکته: این سرویس جهت دریافت لیست سپرده ی اشخاص حقیقی و حقوقی ایرانی طراحی شده است و برای اتباع خارجی نمی توان از این سرویس استفاده کرد.
| توضیحات | مقدار | نام پارامتر | |
| ورودی | |||
| Header | |||
| توکن ثابت کسب وکار، که از پنل کسب وکار قابل دریافت است | yourBusinessToken | _token_ | |
| این پارامتر همواره دارای مقدار ثابت 1 است . | 1 | _token_issuer_ | |
| این پارامتر نوع داده ارسالی به سرور را مشخص میکند که همواره باید دارای مقدار ثابت application/x-www-form-urlencoded' باشد | application/x-www-form-urlencoded | Content-Type | |
| Body | |||
| شناسه سرویس | 1077447 | scProductId | |
| این مقدار را بعد از درخواست سرویس و تایید پادیوم ، میتوانید از پنل یا از طریق api دریافت نمایید. | کلید فراخوانی سرویس | scApiKey | |
| یک JSON شامل پارامترهای موردنیاز با ساختار key:value | {"CustomerId":"123456789"} | request | |
| request | |||
| شماره ی مشتری در بانک پاسارگاد | 123456789 | CustomerId | |
| کد ملی اشخاص حقیقی/ شناسه ملی اشخاص حقوقی | 0081234567 | NationalId | |
| * نکته: ارسال یکی از پارامترهای شماره مشتری و یا کد ملی / شناسه ملی اجباری است. | |||
| خروجی | |||
| در صورت وقوع خطا در فراخوانی سرویس true خواهد بود. توصیه می شود این پارامتر را برای هر درخواست ذخیره کنید. | true/false | hasError | |
| جهت بررسی لاگ درخواست و ریسپانس توسط کارشناسان پادیوم ، استفاده میشود. | string | referenceNumber | |
| حاوی نتایج نهایی و پاسخ سرویس | jsonObject | result.result | |
| موفق یا ناموفق بودن دریافت لیست سپرده ها | true/false | IsSuccess | |
| پاسخ نهایی سرویس شامل آرایه ای از لیست سپرده های مشتری | jsonArray | ResultData | |
| ResultData | |||
| شماره حساب | string | AccountNumber | |
| شماره شبا | string | Iban | |
| نوع حساب | object | AccountType | |
| تاریخ ایجاد | string | CreateDate | |
| وضعیت حساب | string | AccountStatus | |
| تاریخ آخرین تغییرات | string | LastChangeDate | |
| موجودی واقعی | string | ActualAmount | |
| مانده قابل برداشت | string | AvailableAmount | |
| مبلغ بستانکاری | string | BesAmount | |
| مبلغ بدهکاری | string | BedAmount | |
| مبلغ مسدودی | string | BlockAmount | |
| تاریخ مسدودی | string | BlockDate | |
| تعداد مهر، تمبر | string | stampCount | |
| تعداد امضاء | string | signCount | |
| شرح امضاء | string | signDescription | |
| نوع مالکیت حساب | object | AccountOwnershipType | |
| کد شعبه ی ایجاد کننده | string | createBranchCode | |
| نوع حساب پشتیبان | string | AccountHaveSupportType | |
| نوع حق برداشت | object | RightOfWithdrawalType | |
| کد شعبه متولی | string | TrusteeBranchcode | |
| AccountType | |||
| شرح | string | Description | |
| کد | string | Code | |
| RightOfWithdrawalType و AccountOwnershipType | |||
| نام | string | Name | |
| شرح | string | Description | |
| کد | string | Code | |
| نمونه درخواست | |||
| bash
| |||
| نمونه پاسخ | |||
| json
| |||
اطلاعات سپرده مشتری
شناسه سرویس: 1077449
از این سرویس جهت استعلام جزئیات سپرده ی مشتری استفاده می گردد. به نحوی که در ورودی، شماره سپرده دریافت شده و در خروجی، مشخصات سپرده مشتری (مشخصات صاحب/صاحبین حساب، وضعیت سپرده و...) نمایش داده می شود.
* نکته: این سرویس جهت دریافت اطلاعات سپرده ی اشخاص حقیقی و حقوقی ایرانی طراحی شده است و برای اتباع خارجی نمی توان از این سرویس استفاده کرد.
| توضیحات | مقدار | نام پارامتر | |
| ورودی | |||
| Header | |||
| توکن ثابت کسب وکار، که از پنل کسب وکار قابل دریافت است | yourBusinessToken | _token_ | |
| این پارامتر همواره دارای مقدار ثابت 1 است . | 1 | _token_issuer_ | |
| این پارامتر نوع داده ارسالی به سرور را مشخص میکند که همواره باید دارای مقدار ثابت application/x-www-form-urlencoded' باشد | application/x-www-form-urlencoded | Content-Type | |
| Body | |||
| شناسه سرویس | 1077449 | 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 | |
| پاسخ نهایی سرویس شامل اطلاعات سپرده | jsonArray | ResultData | |
| ResultData | |||
| مشخصات صاحب/صاحبین حساب (در صورت مشترک بودن حساب، لیستی از مشخصات صاحبین حساب ارائه میگردد) | object | DepositOwnerInfos | |
| شرایط برداشت (در صورت وجود بیش از یک شرط آرایهای از شرایط نمایش داده میشود) | string (object) | WithdrawConditions | |
| وضعیت سپرده | int | DepositStatus | |
| نام محصول سپرده | string | DepositTypeTitle | |
| DepositOwnerInfos | |||
| نام | string | FirstName | |
| نام خانوادگی | string | LastName | |
| نام پدر | string | FatherName | |
| کد ملی | string | NationalCode | |
| شماره تلفن | string | PhoneNumber | |
| موبایل | string | MobileNumber | |
| نمونه درخواست | |||
| bash
| |||
| نمونه پاسخ | |||
| json | |||
دریافت صورتحساب سپرده
شناسه سرویس: 1077467
از این سرویس جهت دریافت صورتحساب سپرده‌ی مشتری استفاده میشود.
| توضیحات | مقدار | نام پارامتر | |
| ورودی | |||
| Header | |||
| توکن ثابت کسب وکار، که از پنل کسب وکار قابل دریافت است | yourBusinessToken | _token_ | |
| این پارامتر همواره دارای مقدار ثابت 1 است . | 1 | _token_issuer_ | |
| این پارامتر نوع داده ارسالی به سرور را مشخص میکند که همواره باید دارای مقدار ثابت application/x-www-form-urlencoded' باشد | application/x-www-form-urlencoded | Content-Type | |
| Body | |||
| شناسه سرویس | 1077467 | scProductId | |
| این مقدار را بعد از درخواست سرویس و تایید پادیوم ، میتوانید از پنل یا از طریق api دریافت نمایید. | کلید فراخوانی سرویس | scApiKey | |
| یک JSON شامل پارامترهای موردنیاز با ساختار key:value | json
| request | |
| request | |||
| شماره سپرده | string* | DepositNumber | |
| تاریخ خیامی شروع (yyyy/mm/dd) | *string | FromDate | |
| تاریخ خیامی پایان (yyyy/mm/dd) | *string | ToDate | |
| اولین نتیجه ازصفرشروع میشود | int | FirstIndex | |
| تعداد نتیجه | *int | ResultCount | |
| کد ارز | string | Currencies | |
| زمان شروع (HH:mm:ss) | string | FromTime | |
| زمان پایان (HH:mm:ss) | string | ToTime | |
| خروجی | |||
| در صورت وقوع خطا در فراخوانی سرویس true خواهد بود | true/false | hasError | |
| جهت بررسی لاگ درخواست و ریسپانس توسط کارشناسان پادیوم ، استفاده میشود. توصیه می¬شود این پارامتر را برای هر درخواست ذخیره کنید. | string | referenceNumber | |
| حاوی نتایج نهایی و پاسخ سرویس | jsonObject | result.result | |
| موفق یا ناموفق بودن دریافت لیست سپرده ها | true/false | IsSuccess | |
| پاسخ سرویس شامل اطلاعات و لیست صورتحساب | jsonArray | ResultData | |
| ResultData | |||
| اطلاعات سپرده | jsobObject | DepositInfo | |
| لیست صورتحساب | jsonArray | Statements | |
| DepositInfo | |||
| شماره سپرده | string | DepositNumber | |
| کد نوع سپرده | string | Number | |
| عنوان سپرده | string | Title | |
| کد نوع سپرده | string | DepositTypeKind | |
| سپرده ویژه | bool | IsSpecial | |
| حق برداشت | bool | WithdrawRight | |
| حق واریز | bool | DepositRight | |
| مانده واقعی | string | CurrentAmount | |
| مانده قابل برداشت | string | CurrentWithdrawableAmount | |
| نام ارز | string | CurrencyName | |
| کد سوییفت ارز | string | CurrencySwiftCode | |
| کد ارز | string | CurrencyISOCode | |
| Statement | |||
| نام کاربری | string | UserName | |
| مبلغ بدهکاری | string | DebtorAmount | |
| مبلغ بستانکار | string | CreditorAmount | |
| کد شعبه | string | BranchCode | |
| Ip دستگاه | string | MachineIP | |
| شماره سپرده | string | DepositNumber | |
| مانده بعد از تراکنش | string | Amount | |
| شماره سند | string | DocNumber | |
| مبلغ تراکنش | string | TransactionAmount | |
| تاریخ | string | Date | |
| زمان | string | Time | |
| شرح | string | Description | |
| کد کاربر | string | UserCode | |
| نام ارز | string | CurrencyName | |
| کد تراکنش | string | TransactionCode | |
| شناسه قبض | string | TransferMoneyBillNumber | |
| کد | string | Code | |
| نمونه درخواست | |||
| bash | |||
| نمونه پاسخ | |||
| json | |||
پارامترهای فیلد خروجی - SatnaResult
| توضیح | نوع فیلد | نام فیلد |
| شماره سپرده واریز وجه بازگشتی | String | SourceReturnDepositNumber |
| شماره مشتری مبدا | String | SourceCustomerNumber |
| نام / نوع موسسه | String | SourceName |
| نام خانوادگی / نوع موسسه | String | SourceLastName |
| مبلغ وجه واریزی | رشته عددی | Amount |
| نام دریافت کننده | String | RecieverName |
| نام خانوادگی دریافت کننده | String | RecieverLastName |
| نام بانک مقصد | String | DestinationBankName |
| نام شعبه مقصد | String | DestinationBranchName |
| شماره شبای مشتری مقصد | String | RecieverDepositNumber |
| شماره پیگیری مشتری | String | UserRefrenceNumber |
| زمان ثبت درخواست | String | CreationTime |
| تاریخ ثبت درخواست | String | CreationDate |
| نام و نام خانوادگی ثبت کننده درخواست | String | UserName |
| تاریخ ارسال پیام – اگر درخواست تاریح ارسال داشته باشد وجود دارد . | String | SendDate |
| زمان ارسال پیام – اگر درخواست ساعت ارسال داشته باشد وجود دارد . | String | SendTime |
| کد وضعیت پیام | String | StatusCode |
| عنوان وضعیت پیام | String | StatusValue |
| نوع درگاه: شعبه : TELLER اینترنت بانک : INTERNET همراه بانک : MOBILE تلفن بانک : TELEPHONE | String | TransactionChannelType |
| تاریخ موثر | String | DueDate |
| شماره شبای مبدا | String | SourceIban |
| شماره سند – چون ممکن است بیش از یک سند به ازای شماره تراکنش مورد نظر صاده شده باشد ، تمام شماره سندهای مرتبط با کاما از هم جدا میشوند . | String | DocumentNumber |
| کد تراکنش | String | TransactionNumber |
| کد بانک مقصد | String | DestinationBankCode |
| کد سوئیفت بانک مقصد | String | DestinationBankSwiftCode |
| شماره سپرده مبدا | String | SenderDepositNumber |
| شماره پیگیری از بانک | String | RefrenceNumber |
پارامترهای فیلد خروجی - PayaResult
| توضیح | نوع فیلد | نام فیلد |
| شماره پیگیری | String | RefrenceNumber |
| تاریخ درخواست | String | ExecutionDate |
| تاریخ و زمان ثبت | String | TransactionDateTime |
| مبلغ | String | Amount |
| بانک مقصد | رشته عددی | BankSwiftCode |
| وضعیت تراکنش – مطابق جدول پایا | String | State |
| وضعیت تراکنش با فرمت جدید – مطابق جدول وضعیت جدید پایا | String | NewFormatState |
| شعبه ثبت کننده درخواست | String | BranchCode |
| شبای مبدا | String | SourceIban |
| سپرده مبدا | String | SourceDepositNumber |
| شبای مقصد | String | DestinationIban |
| شرح | String | SourceComment |
| نام و نام خانوادگی گیرنده | String | AccountName |
| شماره سند | String | DocumentNumber |
| شماره تراکنش | String | TransactionNumber |
| کد بانک مقصد | String | DestinationBankCode |
| نام بانک مقصد | String | DestinationBankName |
پارامترهای فیلد خروجی - SuccessBatchPaya
| نام فیلد | نوع فیلد | توضیحات |
| شماره پیگیری | String | EndNew |
| مبلغ | String | Amount |
| شبای مقصد | String | DestinationIban |
| شناسه تراکنش | String | TransactionId |
| وضعیت پایا در فرمت جدید – مطابق جدول | String | NewFormatState |
| نتیجه موفق یا ناموفق | Boolean | IsSuccess |
پارامترهای فیلد خروجی - UnSuccessBatchPaya
| نام فیلد | نوع فیلد | توضیحات |
| شناسه تراکنش | String | TransactionId |
| نتیجه موفق یا ناموفق | String | IsSuccess |
| پیغام | String | Message |
| کد پاسخ | String | RsCode |
خروجی ناموفق –Error List
| نام فیلد | نوع فیلد | توضیحات |
| کد خطا | String | Code |
| پیغام خطا | String | Desc |
| نام پارامتر دارای خطا | String | ParamName |
| مسیر پارامتر دارای خطا | String | ParamaPath |
وضعیت پایا – فرمت قدیمی - فیلد state
| نام فارسی | وضعیت اصلی پایا | نام وضعیت |
| ارسالی - ثبت شده | ثبت شده تایید شده در شعبه رد شده در شعبه پایا ثبت و واریز شده | Registred |
| ارسالی – تایید شده | تایید شده در شعبه پایا | Confirmed |
| ارسالی – حذف شده | لغو شده در شعبه | deleted |
| ارسالی – رد شده توسط بانک مقابل | رد شده توسط بانک مقصد – عدم ثبت سند | rejected |
| ارسالی – ارسال شده به بانک مرکزی | نوشته شده در فایل | sent |
| ارسالی – دریافت شده توسط بانک مرکزی | تایید شده توسط بانک مرکزی | send_recieved |
| ارسالی – رد شده توسط بانک مرکزی | رد شده توسط بانک مرکزی ( معنایی ) | centralbank_rejected |
| دریافتی – رد شده – برگشت به بانک مرکزی | این وضعیت در حال حاضر توسط این سرویس برگردانده نمیشود. | rct_sent_recived |
| دریافتی – رد شده – برگشت به بانک مرکزی | این وضعیت در حال حاضر توسط این سرویس برگردانده نمیشود. | rct_sent |
| دریافتی – دریافت شده از بانک مرکزی | این وضعیت در حال حاضر توسط این سرویس برگردانده نمیشود. | rct_rcvd |
| دریافتی – سند زده شده | این وضعیت در حال حاضر توسط این سرویس برگردانده نمیشود. | rct_acpt |
| دریافتی رد شده . | این وضعیت در حال حاضر توسط این سرویس برگردانده نمیشود. | ict_rjcd |
وضعیت پایا – فرمت جدید - فیلد NewFormatState
| نام فارسی | نام وضعیت |
| ثبت شده داخلی | ACH_CT_INTERNAL_REGISTER_STATE |
| ثبت داخلی خطادار | ACH_CT_REGISTER_AND_ERROR_STATE |
| رد شده توسط بانک مرکزی (معنایی) – عدم ثبت سند | ACH_CT_REJECTED_BY_REJ_NOT_ISSUED |
| ثبت شده | ACH_CT_REGISTER_STATE |
| ثبت و واریز شده | ACH_CT_REGISTER_AND_PAID_STATE |
| لغو شده | ACH_CT_CANCEL_STATE |
| تایید شده در شعبه | ACH_CT_CONFIRM_STATE |
| تایید شده در شعبه پایا | ACH_CT_CONFIRM_IN_ACH_BRANCH_STATE |
| رد شده در شعبه پایا | ACH_CT_CANCEL_IN_ACH_BRANCH_STATE |
| نوشته شده در فایل | ACH_CT_WRITTEN_IN_FILE_STATE |
| رد شده توسط بانک مرکزی | ACH_CT_REJECTED_BY_RR |
| تایید شده توسط بانک مرکزی | ACH_CT_ACCEPTED_BY_RR |
| رد شده توسط بانک مرکزی (معنایی) | ACH_CT_REJECTED_BY_REJ |
| رد شده توسط بانک مقصد | ACH_CT_REJECTED_BY_DEST_BANK_STATE |
| رد شده توسط بانک مقصد-عدم ثبت سند | ACH_CT_REJECTED_BY_DEST_BANK_STATE_NOT_ISSUED |
جدول وضعیت های ساتنا
| نام فارسی | وضعیت منطبق شده |
| ثبت شده در شعبه | REGISTERED_IN_BRANCH |
| ارسال شده به شعبه ساتنا | SENT_TO_CENTER |
| رد شده در شعبه | REJECTED_IN_BRANCH |
| آماده ارسال به بانک مرکزی | READY_TO_SEND_TO_CENTRAL_BANK |
| رد شده در شعبه ساتنا | REJECTED_IN_SATNA_BRANCH |
| مردودی مسترد به مشتری | REJECTED_CASH_RETURNED |
| رد شده در هنگام ارسال – ارسال شده به شعبه ساتنا | SENT_TO_CENTER_AFTER_REJECTING_SEND |
| ارسال شده به بانک مرکزی | C2C_SENT_TO_CENTRAL_BANK |
| دریافتی | C2C_RECIEVED_UNAMBIGUOUS |
| دریافتی نگینی | C2C_RECIEVED_AMBIGUOUS |
| دریافتی واریز شده | C2C_RECIEVED_APPROVED |
| دریافتی رد شده | C2C_RECIEVED_REJECTED |
| رد شده در بانک مقصد | C2C_REJECTED_IN_DEST_BANK |
| دریافتی نگینی – فایل تولید شده | C2C_EXIST_IN_FILE |
| پیام مشتری به مشتری واریز شده در فایل | C2C_PAYED_IN_FILE |
| پیام مشتری به مشتری واریز نشده در فایل | C2C_NOT_PAYED_IN_FILE |
| رد شده در شعبه – مردودی مسترد به مشتری | REJECTED_IN_BRANCH_REJECTED_CASH_RETURNED |
| رد شده در شعبه ساتنا – مردودی مسترد به مشتری | REJECTED_IN_SATNA_BRANCH_REJECTED_CASH_RETURNED |
| رد شده در بانک مقصد – مردودی مسترد به مشتری | C2C_REJECTED_IN_DEST_BANK_REJECTED_CASH_RETURNED |
| رد شده در بانک مرکزی | C2C_REJECTED_IN_CENTRAL_BANK |
| تسویه شده در بانک مرکزی | C2C_PONIED_IN_CENTRAL_BANK |
جدول برخی از RsCode – سرویس استعلام وضعیت نهایی تراکنش
| کد خطا | عنوان خطا | توضیحات |
| 1 | عملیات با موفقیت انجام شد |
|
| 0 | به علت بروز مشکل عملیات شما انجام نشد |
|
| 1038 | اطلاعات ورودی اشتباه است |
|
| 1079 | سپرده ای با شماره .X.X.X.X وجود ندارد |
|
| 1108 | تراکنش یافت نشد |
|
| 1119 | مبلغ موجودی سپرده مذکور از حداقل موجودی مجاز سپرده کمتر می باشد | دقت شود که موجودی حساب مشتری برابر یا بیشتر از مجموع مبلغ انتقال و کارمزد پایا باشد. |
| 1379 | مبلغ تراکنش نمیتواند صفر باشد . |
|
| 2114 | نوع تراکنش نامعتبر است |
|
| 2941 | مقداری برای پارامتر ورودی اجباری ارسال نشده است . | در صورتیکه مطابق با مستند پارامترهای اجباری ارسال نشود. |
جستجوی تراکنش پایا
شناسه سرویس: 1240530
این سرویس با دریافت اطلاعات ورودی مربوط به عملیات پایا، تراکنش پایا را جستجو کرده و نتیجه مربوطه را نمایش میدهد.
نمای کلی چرخه پایا :
شروع :
1- ثبت اولیه در شعبه ( در اینجا شعبه اینترنتی بانک پاسارگاد که توسط کسب وکا و با اجرای سرویس انتقال پایا انجام میشود)
2- ارشد صندوق تایید می کند ( که در اینجا توسط ارسال فیلد isAutoVerify=true در سرویس انتقال پایا توسط کسب وکار انجام میشود)
* در این مرحله 3 وضعیت روی میدهد : 1- تایید شده در شعبه 2-تایید شده در شعبه پایا 3- نوشته شده در فایل
3- ورود به چرخه پایا : عملیات پایا در ساعات مشخصی از روزانجام میشود.
4- پایان و تعیین وضعیت : در این مر حله 3 وضعیت روی میدهد :
- تایید شده توسط بانک مرکزی - رد شده توسط بانک مرکزی - رد شده توسط بانک مقصد
* نکته: اگر انتقال وجه ، پاسارگاد به پاسارگاد باشد ، انتقال پایا وارد چرخه ی پایا نمی شود و بلا فاصله به وضعیت ( ثبت و واریز شده ) وارد میشود و پول از حساب مبدا به حساب مقصد جابجا میشود .
| توضیحات | مقدار | نام پارامتر |
| ورودی | ||
| Header | ||
| توکن ثابت کسب وکار، که از پنل کسب وکار قابل دریافت است | yourBusinessToken | _token_ |
| این پارامتر همواره دارای مقدار ثابت 1 است . | 1 | _token_issuer_ |
| این پارامتر نوع داده ارسالی به سرور را مشخص میکند که همواره باید دارای مقدار ثابت application/x-www-form-urlencoded' باشد | application/x-www-form-urlencoded | Content-Type |
| Body | ||
| شناسه سرویس | 1240530 | scProductId |
| این مقدار را بعد از درخواست سرویس و تایید پادیوم ، میتوانید از پنل یا از طریق api دریافت نمایید. | کلید فراخوانی سرویس | scApiKey |
| یک JSON شامل پارامترهای موردنیاز با ساختار key:value | json
| request |
| request | ||
| شماره سپرده‌ی مبدا | string* | SourceDepositNumber |
| شماره پیگیری | string* | TransactionNumber |
| تعداد از (لیست خروجی) | string* | FirstResult |
| تعداد تا (لیست خروجی) | string* | MaxResult |
| تاریخ ثبت از (YYYY/MM/DD) | string* | FromDate |
| تاریخ ثبت تا (YYYY/MM/DD) | string* | ToDate |
| تاریخ تراکنش از (YYYY/MM/DD) | string | FromTransactionDate |
| تاریخ تراکنش تا (YYYY/MM/DD) | string | ToTransactionDate |
| وضعیت مقادیر طبق جدول وضعیت‌های پایا درج شود. مقدار این فیلد حاوی یکی از وضعیت‌های پایا میباشد که به منظور دریافت لیست پایا میتوان از تمامی مقادیر جدول‌های مربوط به فیلدهای status و NewFormatState استفاده کرد. | string | Status |
| مبلغ از | string | FromAmount |
| مبلغ تا | string | ToAmount |
| شبای ذینفع (مقصد) | string | DestinationIban |
| شناسه فایل ثبت گروهی | string | FileUniqueIdentifier |
| نام گیرنده باید دقیقا آنچه در ثبت پایا وارد شده است، وارد شود. | string | ReceiverFirstName |
| نام گیرنده باید دقیقا آنچه در ثبت پایا وارد شده است، وارد شود. | string | ReceiverLastName |
| کد شعبه ثبت کننده درخواست | string | BranchCode |
| کاربر ثبت کننده | string | BankerId |
| بانک مقصد | string | Bank |
| فیلد MaxResult: در صورت ارسال فیلد fileUniqueIdentifier به منظور دریافت لیست پایای گروهی مقدار فیلد MaxResult باید برابر با طول فایل fileUniqueIdentifier (تعداد رکوردهای ثبت گروهی) و یا بیشتر از آن باشد. فیلد FromDate: در صورتیکه مقداری برای فیلد TransactionNumber و FileUniqueIdentifier ارسال نگردد. مقدار این فیلد ارسال گردد. فیلد ToDate: در صورتیکه مقداری برای فیلد TransactionNumber و FileUniqueIdentifier ارسال نگردد. مقدار این فیلد ارسال گردد. | ||
| Status جدول وضعیت‌های پایا | ||
| نام فارسی | وضعیت های اصلی پایا | وضعیت منطبق شده |
| ارسالی – ثبت شده | ثبت شده تایید شده در شعبه رد شده در شعبه پایا ثبت و واریز شده | Registered |
| ارسالی – تایید شده | تایید شده در شعبه پایا | Confirmed |
| ارسالی – حذف شده | لغو شده در شعبه | Deleted |
| ارسالی – رد شده توسط بانک مقابل | رد شده توسط بانک مقصد رد شده توسط بانک مقصد – عدم ثبت سند | Rejected |
| ارسالی - ارسال شده به بانک مرکزی | نوشته شده در فایل | Sent |
| ارسالی - دریافت شده توسط بانک | تایید شده توسط بانک مرکزی | Sent_recieved |
| ارسالی- رد شده توسط بانک مرکزی | رد شده توسط بانک مرکزی رد شده توسط بانک مرکزی (معنایی) | Centralbank_rejected |
| دریافتی-رد شده-دریافت شده توسط بانک مرکزی | این وضعیت در حال حاضر توسط این سرویس برگردانده نمیشود. | Rct_sent_recieved |
| دریافتی-رد شده-برگشت به بانک مرکزی | این وضعیت در حال حاضر توسط این سرویس برگردانده نمیشود. | Rct_sent |
| دریافتی-دریافت شده از بانک مرکزی | این وضعیت در حال حاضر توسط این سرویس برگردانده نمیشود. | Ict_rcvd |
| دریافتی-سند زده شده | این وضعیت در حال حاضر توسط این سرویس برگردانده نمیشود. | Ict_acpt |
| دریافتی-رد شده | این وضعیت در حال حاضر توسط این سرویس برگردانده نمیشود. | Ict_rjcd |
| NewFormatState انواع وضعیت‌های یک درخواست پایا با فرمت جدید | ||
| نام فارسی | وضعیت پایا | |
| ثبت شده داخلی | ACH_CT_INTERNAL_REGISTER_STATE | |
| ثبت داخلی خطادار | ACH_CT_REGISTER_AND_ERROR_STATE | |
| رد شده توسط بانک مرکزی (معنایی) – عدم ثبت سند | ACH_CT_REJECTED_BY_REJ_NOT_ISSUED | |
| ثبت شده | ACH_CT_REGISTER_STATE | |
| ثبت و واریز شده | ACH_CT_REGISTER_AND_PAID_STATE | |
| لغو شده | ACH_CT_CANCEL_STATE | |
| تایید شده در شعبه | ACH_CT_CONFIRM_STATE | |
| تایید شده در شعبه پایا | ACH_CT_CONFIRM_IN_ACH_BRANCH_STATE | |
| رد شده در شعبه پایا | ACH_CT_CANCEL_IN_ACH_BRANCH_STATE | |
| نوشته شده در فایل | ACH_CT_WRITTEN_IN_FILE_STATE | |
| رد شده توسط بانک مرکزی | ACH_CT_REJECTED_BY_RR | |
| تایید شده توسط بانک مرکزی | ACH_CT_ACCEPTED_BY_RR | |
| رد شده توسط بانک مرکزی (معنایی) | ACH_CT_REJECTED_BY_REJ | |
| رد شده توسط بانک مقصد | ACH_CT_REJECTED_BY_DEST_BANK_STATE | |
| رد شده توسط بانک مقصد-عدم ثبت سند | ACH_CT_REJECTED_BY_DEST_BANK_STATE_NOT_ISSUED | |
| خروجی | ||
| در صورت وقوع خطا در فراخوانی سرویس true خواهد بود | true/false | hasError |
| جهت بررسی لاگ درخواست و ریسپانس توسط کارشناسان پادیوم ، استفاده میشود. توصیه می شود این پارامتر را برای هر درخواست ذخیره کنید. | string | referenceNumber |
| حاوی نتایج نهایی و پاسخ سرویس | jsonObject | result.result |
| موفق یا ناموفق بودن دریافت لیست سپرده ها | true/false | IsSuccess |
| پاسخ سرویس شامل آرایه ای از تراکنشها | jsonArray | ResultData |
| ResultData | ||
| شماره پیگیری | string | ReferenceNumber |
| تاریخ درخواست | string | ExecutionDate |
| تاریخ و زمان ثبت | string | TransactionDateTime |
| مبلغ | string | Amount |
| بانک مقصد | string | BankSwiftCode |
| وضعیت تراکنش مطابق جدول Status | string | State |
| شعبه ثبت کننده درخواست | string | BranchCode |
| شبای مبدا | string | SourceIban |
| سپرده مبدا | string | SourceDepositNumber |
| شبای مقصد | string | DestinationIban |
| شرح | string | SourceComment |
| نام و نام خانوادگی گیرنده | string | AccountName |
| وضعیت با فرمت جدید مطابق جدول NewFormatState | string | NewFormatState |
| شماره سند در صورتی که بیش از یک سند به ازای شماره تراکنش مورد نظر صادر شده باشد، تمام شماره سندهای مرتبط با ویرگول از هم جدا میشوند. | string | DocumentNumber |
| شماره تراکنش | string | TransactionNumber |
| نمونه درخواست | ||
| bash
| ||
| نمونه پاسخ | ||
| json
| ||
جستجوی تراکنش ساتنا
شناسه سرویس: 1241492
این سرویس با دریافت اطلاعات ورودی مربوط به عملیات ساتنا، تراکنش ساتنا را جستجو کرده و نتیجه مربوطه را نمایش میدهد.
* حداقل مبلغ برای انتقال ساتنا 50 میلیون تومان است . با مبلغی کمتر از این از پایا استفاده نمایید.
* برای مبالغ بالای 100 میلیون تومان بهتر است که مبلغ تراکنش ، به اعداد کوچکتر شکسته شود.سپس ساتناهای جداگانه زده شود.
| توضیحات | مقدار | نام پارامتر | |
| ورودی | |||
| Header | |||
| توکن ثابت کسب وکار، که از پنل کسب وکار قابل دریافت است | yourBusinessToken | _token_ | |
| این پارامتر همواره دارای مقدار ثابت 1 است . | 1 | _token_issuer_ | |
| این پارامتر نوع داده ارسالی به سرور را مشخص میکند که همواره باید دارای مقدار ثابت application/x-www-form-urlencoded' باشد | application/x-www-form-urlencoded | Content-Type | |
| Body | |||
| شناسه سرویس | 1241492 | scProductId | |
| این مقدار را بعد از درخواست سرویس و تایید پادیوم ، میتوانید از پنل یا از طریق api دریافت نمایید. | کلید فراخوانی سرویس | scApiKey | |
| یک JSON شامل پارامترهای موردنیاز با ساختار key:value | { } | request | |
| request | |||
| شماره سپرده‌ی مبدا | string* | SourceDepositNumber | |
| شماره پیگیری | string | TransactionNumber | |
| تاریخ درخواست از (YYYY/MM/DD) | string | RequestFromDate | |
| تاریخ درخواست تا (YYYY/MM/DD) | string | RequestToDate | |
| وضعیت مقادیر طبق جدول وضعیت‌های ساتنا درج شود. | string | Status | |
| مبلغ از | string | FromAmount | |
| مبلغ تا | string | ToAmount | |
| شبای ذینفع (مقصد) | string | DestinationIban | |
| ایندکس اولین نتیجه (با توجه به نوع عددی این فیلد در صورت عدم مقدار باید اصفر ارسال گردد و نمیتواند null باشد.) | int* | FirstResult | |
| ایندکس آخرین نتیجه (این فیلد اجباری میباشد و دقت نمایید عدم مقداردهی و یا ارسال مقدار صفر، به منزله عدم نمایش رکورد در خروجی بوده و لذا ResultData مقدار null خواهد داشت.) | int* | MaxResult | |
| نام / نام موسسه ذینفع | string | ReceiverFirstName | |
| نام خانوادگی/ نوع موسسه ذینفع | string | ReceiverLastName | |
| کد شعبه | string | BranchCode | |
| شماره مشتری (اگر ساتنا از نوع C2C باشد وارد کردن این فیلد اجباری است) | string | CustomerNumber | |
| نوع ساتنا باید به صورت B2C یا C2C وارد شود. | string | TypeId | |
| شماره پیگیری بانک | string | ReferenceNumber | |
| شماره پیگیری مشتری | string | UserReferenceNumber | |
| status جدول وضعیت های ساتنا | |||
| نام فارسی | وضعیت منطبق شده | ||
| ثبت شده در شعبه | REGISTERED_IN_BRANCH | ||
| ارسال شده به شعبه ساتنا | SENT_TO_CENTER | ||
| رد شده در شعبه | REJECTED_IN_BRANCH | ||
| آماده ارسال به بانک مرکزی | READY_TO_SEND_TO_CENTRAL_BANK | ||
| رد شده در شعبه ساتنا | REJECTED_IN_SATNA_BRANCH | ||
| مردودی مسترد به مشتری | REJECTED_CASH_RETURNED | ||
| رد شده در هنگام ارسال – ارسال شده به شعبه ساتنا | SENT_TO_CENTER_AFTER_REJECTING_SEND | ||
| ارسال شده به بانک مرکزی | C2C_SENT_TO_CENTRAL_BANK | ||
| دریافتی | C2C_RECIEVED_UNAMBIGUOUS | ||
| دریافتی نگینی | C2C_RECIEVED_AMBIGUOUS | ||
| دریافتی واریز شده | C2C_RECIEVED_APPROVED | ||
| دریافتی رد شده | C2C_RECIEVED_REJECTED | ||
| رد شده در بانک مقصد | C2C_REJECTED_IN_DEST_BANK | ||
| دریافتی نگینی – فایل تولید شده | C2C_EXIST_IN_FILE | ||
| پیام مشتری به مشتری واریز شده در فایل | C2C_PAYED_IN_FILE | ||
| پیام مشتری به مشتری واریز نشده در فایل | C2C_NOT_PAYED_IN_FILE | ||
| رد شده در شعبه – مردودی مسترد به مشتری | REJECTED_IN_BRANCH_REJECTED_CASH_RETURNED | ||
| رد شده در شعبه ساتنا – مردودی مسترد به مشتری | REJECTED_IN_SATNA_BRANCH_REJECTED_CASH_RETURNED | ||
| رد شده در بانک مقصد – مردودی مسترد به مشتری | C2C_REJECTED_IN_DEST_BANK_REJECTED_CASH_RETURNED | ||
| رد شده در بانک مرکزی | C2C_REJECTED_IN_CENTRAL_BANK | ||
| تسویه شده در بانک مرکزی | C2C_PONIED_IN_CENTRAL_BANK | ||
| خروجی | |||
| در صورت وقوع خطا در فراخوانی سرویس true خواهد بود | true/false | hasError | |
| جهت بررسی لاگ درخواست و ریسپانس توسط کارشناسان پادیوم ، استفاده میشود. توصیه می شود این پارامتر را برای هر درخواست ذخیره کنید. | string | referenceNumber | |
| حاوی نتایج نهایی و پاسخ سرویس | jsonObject | result.result | |
| موفق یا ناموفق بودن دریافت لیست سپرده ها | true/false | IsSuccess | |
| پاسخ نهایی سرویس شامل | jsonArray | ResultData | |
| ResultData | |||
| شماره سپرده واریز وجه بازگشتی | string | SourceReturnDepositNumber | |
| شماره مشتری مبدا | string | SourceCustomerNumber | |
| نام / نوع موسسه | string | SourceName | |
| نام خانوادگی / نام موسسه | string | SourceLastName | |
| مبلغ وجه واریزی | string | Amount | |
| نام دریافت‌کننده | string | RecieverName | |
| نام خانوادگی دریافت‌کننده | string | RecieverLastName | |
| نام بانک مقصد | string | DestinationBankName | |
| نام شعبه مقصد | string | DestinationBranchName | |
| شماره شبای مشتری مقصد | string | RecieverDepositNumber | |
| شماره پیگیری مشتری | string | UserReferenceNumber | |
| شماره پیگیری | string | RefrenceNumber | |
| زمان ثبت درخواست | string | CreationTime | |
| تاریخ ثبت درخواست | string | CreationDate | |
| نام و نام خانوادگی ثبت کننده درخواست | string | UserName | |
| تاریخ ارسال پیام | string | SendDate | |
| زمان ارسال پیام | string | SendTime | |
| کد وضعیت پیام | string | StatusCode | |
| عنوان وضعیت پیام | string | StatusValue | |
| نوع درگاه شعبه: TELLER اینترنت‌بانک: INTERNET همراه‌بانک: MOBILE تلفن‌بانک: TELEPHONE | string | TransactionChannelType | |
| تاریخ موثر | string | DueDate | |
| شبا | string | SourceIban | |
| شماره سند – چون ممکن است بیش از یک سند به ازای شماره تراکنش مورد نظر صادر شده باشد، تمام شماره سندهای مرتبط با ویرگول از هم جدا میشوند. | string | DocumentNumber | |
| کد تراکنش | string | TransactionNumber | |
| نمونه درخواست | |||
| bash | |||
| نمونه پاسخ | |||
|
| |||
| خطاهای معمول در پلتفرم | |||
| کد خطا | توضیح | ||
| 21 | توکن کسبوکاری وارد نشده است | ||
| 227 | تایم اوت سرویس اصلی | ||
| 378 | ارسال پاسخ از سرویس اصلی به پلتفرم با مشکل مواجه شده است | ||
کدخطاهای بانکی
در این لینک میتوانید لیست خطاهای موجود در سرویسهای سپرده بانک پاسارگاد را دریافت نمایید .
