انتقال وجه پایا و ساتنا گروهی

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

مجموعه وب سرویسهای  بانک پاسارگاد به شما این امکان را میدهد تا بخش زیادی از فرایندهای مرتبط با سپرده خود را که پیش از این از طریق شعبه و یا اینترنت بانک انجام می دادید

را بی واسطه و مستقیما، استفاده نمایید و در سیستمهای نرم افزاری خود پیاده سازی کنید.   ابتدا با مراجعه به وب سایت www.podium.ir اقدام به ساخت کسب و کار نمایید

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

دانلود فرم درخواست برای شخص حقیقی

دانلود فرم درخواست برای شخص حقوقی

مقدمه

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

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

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

نحوه‌ی ارسال درخواست فعالسازی سرویس ، و دریافت کلید فراخوانی سرویس (   _scApiKey_   ):
برای استفاده از هر سرویس ابتدا باید درخواست فعالسازی آن سرویس را به پادیوم اعلام کنید. 
بعد از بررسی و تایید آن درخواست ، توسط پادیوم ، باید  کلید استفاده و فراخوانی از آن سرویس را دریافت نمایید.
                                                            
برای استفاده از هر سرویس یک کلید فراخوانی باید دریافت شود. :

❖    نکته: این کلید در تمام درخواستهای ارسالی از آن سرویس، ثابت بوده و نیاز نیست برای هر بار فراخوانی سرویس، کلید جدید دریافت نمایید.

دربافت APIKey  از طریق سرویس: 

         شما می‌توانید "کلید فراخوانی" سرویس‌های مورد نظر خود را از طربق فراخوانی سرویس 1384158 ، درخواست دهید و یا کلید آن را دریافت نمایید.
        شما از طریق این سرویس می‌توانید، لیستی از شناسه های سرویس و لیستی از شماره حسابهای خود را که قصد استفاده از آنها را دارید ارسال نمایید.  
 
این سرویس دارای سه پارامتر می باشد: 

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

نمونه خروجی

❖    متناسب با وضعیت پارامتر statusCode  به شما پیغام مناسب داده خواهد شد: 

❖    بعداز تایید ، می‌توانید مجدد این سرویس را برای بدست آوردن کلید scApiKey فراخوانی کنید. 

اگر سرویس درخواستی شما جزء سرویس هایی است که برای استفاده نیاز به شماره حساب دارد: 
1.    اگر قبلا یک یا چند، شماره حساب شما ، توسط پادیوم ثبت شده باشد:  
تنها با ارسال شناسه ی سرویس ، می‌توانید برای تمامی شماره حساب‌های ثبت شده خود ، کلید فراخوانی سرویس scApiKey دریافت نمایید. 

نمونه درخواست

2. اگر قبلا یک یا چند شماره حساب شما, توسط پادیوم ثبت شده باشد و تنها نیاز داشته باشید که برای استفاده یک یا برخی از آن‌ها کلید فراخوانی سرویس دریافت نمایید,

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

نمونه درخواست

ارسال درخواست 

ابتدا وارد سایت پادیوم شده ، سپس در بازارچه ی API ، سرویسهای موردنظر خود را انتخاب و درخواست استفاده از آن مجموعه سرویس را ارسال کنید .

 ایجاد TransactionId

orgCode = در تراکنشهای ساتنا 1311 و در بقیه 4321 ارسال شود.

Random String: یک رشته‌ی تصادفی که به ازای هر کلاینت یکتا است، حداقل طول 8 کاراکتر و حداکثر طول آن 100 است.

Timestamp:  با دقت میلی ثانیه و با فرمت مقابل 20200927212945073

Sum Char Code: جمع کد اسکی کاراکترهای سه بخش قبل

* میتوانید به جای DataTime  از فرمت Epoch TimeStamp استفاده کنید.

در ادامه نمونه کدی جهت ایجاد این مقدار در زبان جاوااسکریپت قرار داده میشود.

شناسه تراکنش (TransactionId) شامل چهار بخش به شکل زیر می‌باشد:

اطلاعیه مهم تراکنش‌های انتقال وجه

در صورت بروز هرگونه خطا هنگام استفاده از سرویسهای انتقال (وجه پایا / ساتنا / داخلی)، پیش از ارسال مجدد درخواست انتقال وجه، موارد زیر را بررسی نمایید:

- ابتدا با استفاده از سرویس نمایش وضعیت تراکنش (1۴2۴918)، تراکنش موردنظر را استعالم نموده و پارامتر TransactionStatus را در خروجی بررسی نمایید .

- در صورتیکه وضعیت تراکنش inProgress بود، منتظر بمانید تا تراکنش به یکی از وضعیت‌های Success یا UnSuccess یا Reversed یا Reversing تغییر نماید.

• توجه داشته باشید که وضعیت inProgress حداکثر تا پایان روز به یکی از حاالت گفته شده تغییر خواهد نمود.

- در صورتیکه وضعیت تراکنش success باشد، به این معنی است که درخواست با موفقیت ثبت و وارد فرایند (سیکل) پایا یا ساتنا و انتقال داخلی شده و از آن پس میتوانید از سرویس 1۴76957 جهت استعلام نهایی تراکنش در فرایند پایا و داخلی یا از سرویس 1۴76960 جهت استعلام نهایی تراکنش در فرایند ساتنا استفاده نمایید.

- اما در صورتیکه تراکنش در یکی از وضعیت‌های UnSuccess یا (Reversing) Reversed بود به این معنی است که فرآیند ارسال درخواست، به سیکل پایا و ساتنا ناموفق بوده است، در نتیجه آن درخواست انتقال وجه که با خطا مواجه شده است را باید با همان TransactionId قبلی و بدون تغییر آن، مجددا در سرویس انتقال وجه (پایا /ساتنا / داخلی) ارسال نمایید تا بدین صورت از انجام پرداخت تکراری جلوگیری شود.

* توجه داشته باشید که به زودی سرویس جدیدی جهت استعلام یکپارچه تراکنش‌ها ارائه خواهد شد.

* شناسه تراکنش (TransactionId): شناسه منحصر به فرد هر تراکنش با مقداری یکتا

استعلام تراکنش گروهی

از این سرویس جهت استعلام تراکنش‌های گروهی پایا/ساتنا استفاده می‌شود.

• شناسه­‌ی سرویس: 1370661

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

• خروجی سرویس: ساختار کلی پاسخ دریافتی در این لینک به تفصیل شرح داده شده است.

بدنه­‌ی پاسخ دریافتی دارای ساختار زیر است:

آبجکت ResultData:

آبجکت ResponseObj:

انتقال پایای گروهی

شناسه­ سرویس: 1370646

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

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

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

مقادیر معتبر برای فیلد DetailType:

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

نکته: شناسه تراکنش (TransactionId و AsyncTrackerId) شامل چهار بخش به شکل زیر می‌باشد:

4321 - Random String – DateTime-Sum Char Code(OrgCode+Random String)

Random String: یک رشته‌ی تصادفی که به ازای هر کلاینت یکتا است، حداقل طول کاراکتر و حداکثر طول آن 100 است.

DateTime: تایم‌استمپ با دقت میلی ثانیه

Sum Char Code: جمع کد اسکی کاراکترهای سه بخش قبل

نمونه درخواست:

خروجی

نکته: referenceNumber پارامتر مهمی است و جهت ردگیری درخواست در پلتفرم استفاده می­شود. توصیه می­شود این پارامتر را برای هر درخواست ذخیره کنید.

نکته: پارامتر errorCode، اگر اروری در فراخوانی سرویس در پلتفرم رخ دهد (hasError = true)، کد ارور در این پارامتر نمایش داده می­شود. در صورت فراخوانی موفق سرویس در پلتفرم (hasError = false)، مقدار این پارامتر 0 است.

نکته: فراخوانی موفق سرویس از روی پلتفرم (hasError = false) الزاما به معنای دریافت پاسخ صحیح از سرویس مد نظر نیست.

بررسی آبجکت result:

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

کدهای خطا (errorCode) معمول در پلتفرم

انتقال ساتنای گروهی

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

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

• شناسه­‌ی سرویس: 2470009

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

در بدنه‌ی درخواست لیستی از تراکنش‌ها در قالب json ارسال می‌شود که هر آبجکت تراکنش شامل پارامترهای زیر است:

مقادیر معتبر برای فیلد DetailType:

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

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

نکته: شناسه تراکنش‌ها (TransactionId و AsyncTrackerId) شامل چهار بخش به شکل زیر می‌باشد:

4321 - Random String – DateTime-Sum Char Code(OrgCode+Random String+DateTime)

Random String: یک رشته‌ی تصادفی که به ازای هر کلاینت یکتا است، حداقل طول کاراکتر و حداکثر طول آن 100 است.

DateTime: تاریخ (میلادی) و ساعت (با فرمت 24ساعته) با دقت میلی‌ثانیه. به‌عنوان مثال:

4321-123456789-20220618113511111-1531

تاریخ و ساعت بالا به 18 ژوئن 2022، ساعت 11:35:11.111 اشاره دارد.

Sum Char Code: جمع کد اسکی کاراکترهای سه بخش قبل

نمونه بدنه درخواست:

• خروجی: ساختار کلی پاسخ دریافتی در این لینک به تفصیل شرح داده شده است.

بدنه‌­ی پاسخ دریافتی دارای ساختار زیر است:

کدهای ارور (errorCode) معمول در پلتفرم

برای مشاهده‌ی کدهای ارور پلتفرم به این لینک مراجعه کنید.

کد خطاهای بانکی

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