خدمات پرداخت کارتابلی
خدمتدهنده
بازارچه پادیوم
-
نمای کلی
حسابهای چند امضایی این امکان را به صاحبان حسابهای تجاری (1.کسب و کارهای حقوقی و 2.شخصی) میدهد تا بتوانند از امکان مدیریت حساب خود برای وضعیتهای چند امضایی کسب و کار استفاده نمایند. به عنوان مثال در یک کسب وکار برای انتقال وجه و برای برداشت از آن حساب، تایید (امضا) چند نفر مورد نیاز است و در نتیجه اگر قصد برداشت از آن سپرده وجود داشته باشد باید انتقال وجه چندمرحلهای یا همان انتقال وجه چند امضایی مورد استفاده قرار گیرد. به طور کل در پلتفرم سرزمین هوشمند پاد، منظور از امضا همان تایید از طریق پیامک و یا وب سرویس میباشد.
در سرویسهای ارائه شده برای حساب چند امضایی، چند نقش تاثیرگذار تعریف شدهاند که هر کدام میتوانند طبق شکل زیر در فرآیند تایید یک تراکنش اثرگذار باشند. این نقشها شامل کاربر درخواستدهنده (ایجادکننده) و کاربر تاییدکننده برای هر تراکنش هستند. وظیفه کاربر درخواستدهنده (ایجادکننده) ایجاد کردن تراکنشهای مالی و وظیفه کاربر تایید کننده، تایید کردن تراکنشهاست، دقیقاً مشابه مدیران میانی و یا صاحبین امضا در یک شرکت.
بعد از تغییر وضعیت یک حساب به حالت چندامضایی دیگر امکان انجام عملیات مالی صرفاً توسط کاربر اصلی کسب وکار در آن حساب وجود نخواهد داشت.
-
درخواست و ایجاد حساب
یک حساب چند امضایی این امکان را کسب وکارها میدهد تا برای عملیاتهای تسویه، انتقال وجه، پرداخت فاکتورها، تعیین اعتبار اختصاصی و یا ثبت بن تخفیف (ووچر) خود، قوانین تایید چند مرحلهای در میان کارکنان خود وضع نمایند. همچنین سرویس حساب های چند امضایی میتواند به نحوی تعیین شود که در هر نوع از درخواستهای مالی، در سقفهای ریالی مختلف و در تعیین نفرات تاییدکننده متفاوت عمل کند. شروط تایید از انعطاف بالایی برخوردارند و میتواند به صورت هم تایید کاربر 1 هم کاربر 2 (and) و یا کاربر 1 یا کاربر 2 (or) نیز تعریف شوند. لازم به ذکر است محدودیتهای مبلغی، هیچ یک از کاربران را در "ایجاد" تراکنش محدود نمیکند بلکه سیکل تایید و گردش کار با توجه به مبلغ تراکنش درخواستی تعیین میشود.
کاربران تعریف شده در یک حساب چند امضایی لازم نیست که به سطح احراز هویت مشخصی رسیده باشند و با تایید کسب و کار میتوانند در حساب چند امضایی همان کسب و کار و در سقف مجاز کسب و کار مربوطه فعال باشند. هر فرد حقیقی میتواند همزمان نقشهای ایجادکننده تراکنشهای مالی و تاییدکننده همان تراکنشها را داشته باشد و یا در یک حالت، در یک نوع از تراکنشهای مالی صرفاً تاییدکننده باشد و در نوع دیگری و یا سقف مالی مجاز دیگری نیز نقش درخواست دهنده داشته باشد.
امکان حذف و ویرایش افراد، مبالغ و سایر شاخص های تعریف شده در حسابهای چند امضایی و یا حذف حالت چند امضایی به طور کل از حساب به طور موقت یا دائم نیز توسط ادمین (شعبه بانک یا نماینده سرزمین هوشمند پاد) مهیاست.
-
تأیید، رد و یا لغو تراکنشها
تأیید درخواست
شماره سرویس : 2775884
دریافت تایید در عملیات برداشت از حساب چند امضایی از طریق پیامک و از طریق وب سرویس انجام میپذیرد که استفاده از این دو روش در هنگام ایجاد یک حساب چند امضایی تعیین میشود. همچنین کاربر از طریق وب سرویس و یا ارسال پاسخ در پیامک، تایید و یا رد درخواست را اعلام میکند. پس از تایید یک سطح از کاربران، کاربران سطح بعدی از طریق پیامک از وجود تراکنش مربوطه مطلع میشوند.
در صورتی که در شروط تعریف شده برای یک نوع از تراکنش، چند نفر به عنوان تاییدکننده وجود داشته باشند با رد درخواست توسط هریک از نفرات، درخواست تایید نخواهد شد. ضمن آنکه در شرایط موازی، یعنی تایید یک نفر از چند نفر به منزله تایید خواهد بود؛ اولویت سیستم با اولین نفری است که درخواست را تایید و یا رد کرده باشد.
در صورتی که در این مرحله موجودی کافی برای انجام عملیات وجود نداشته باشد، عملیات مد نظر در صف انتظار تامین وجه قرار میگیرد تا اعتبار لازم تامین شود
پارامترهای ورودی
نمونه خروجی
رد درخواست
شماره سرویس: 2775885
هر کاربر تاییدکننده که یک درخواست را حساب کاربری خود مشاهده میکند، میتواند آن را تایید و یا رد کند. این سرویس این امکان را مهیا میکند تا رد درخواست (در صورت لزوم همراه را ارائه توضیحات) صورت پذیرد. در صورتی که یک درخواست رد شود، سایر افراد مرتبط به آن تراکنش چند امضایی میتوانند این موضوع را مشاهده کنند تا در صورت لزوم درخواست جدید دیگری ثبت نمایند.
پارامترهای ورودی
نمونه خروجی
لغو درخواست
شماره سرویس: 2775886
هر یک از کاربران تعریف شده در یک حساب چند امضایی (شامل هر یک از حالتهای مختلف تعریف شده بنا به نوع تراکنش و سطح مالی)، شامل درخواست دهنده و تاییدکنندگان میتوانند حتی پس از تایید اولیه خود و قبل از رسیدن به کفایت امضا نسبت به لغو آن درخواست اقدام کنند. درخواستهایی که در صف انتظار موجودی هستند لغو نمیشوند و همچنین در صورتی که درخواستها 10 روز پس از ثبت، تایید یا رد نشده باشند، یه صورت خودکار توسط سیستم لغو میشوند. در صورتی که یک درخواست لغو شود، سایر افراد مرتبط به آن تراکنش میتوانند از این موضوع مطلع شوند تا در صورت لزوم درخواست جدید دیگری ثبت نمایند.
پارامترهای ورودی
نمونه خروجی
json
-
ایجاد تراکنش برای حسابهای چند امضایی (کارتابلی)
در یک حساب چند امضایی درخواست دهنده (ایجادکننده) میتواند نسبت به ثبت یک درخواست مربوطه خود جهت تسویه، انتقال، پرداخت، اعتبار اختصاصی و یا ووچر منجر اقدام نماید. در یک حساب چند امضایی مشخص فقط کاربرانی میتوانند درخواست تراکنش مالی ثبت کنند که از قبل در آن حساب به عنوان کاربر ایجاد کننده تعریف شده باشند. سرویسهای مربوط هر کدام از انواع تراکنشها در لینکهای زیر قابل مشاهده است. در این سرویسها مطابق با سرویس اصلی برای تراکنشها، عملیات انجام خواهد گرفت با این تفاوت که سه پارامتر زیر در این سرویسها نسبت به سرویس اصلی افزوده شده است که منجر میشود عملیات بر روی حساب چند امضایی مد نظر اجرا شود.
پرداخت فاکتور
در یک حساب چند امضایی درخواست دهنده (ایجادکننده) میتواند نسبت به ثبت یک درخواست پرداخت فاکتور اقدام نماید. در یک حساب چند امضایی مشخص، فقط کاربرانی میتوانند درخواست تراکنش مالی ثبت کنند که از قبل در آن حساب به عنوان کاربر ایجاد کننده تعریف شده باشند. سرویسهای مربوط هر کدام از انواع تراکنشها در لینکهای زیر قابل مشاهده است. در این سرویسها مطابق با سرویس اصلی برای تراکنشها، عملیات انجام خواهد گرفت با این تفاوت که سه پارامتر زیر در این سرویسها نسبت به سرویس اصلی افزوده شده است که منجر میشود عملیات بر روی حساب چند امضایی مد نظر اجرا شود.
نحوه عملکرد این سرویس ها مشابه با سرویس های مربوط به حساب های غیر چندامضایی است با این تفاوت که اطلاعات مربوط به حساب و افراد تعریف شده در فرآیند به صورت چند امضایی (کارتابلی) تاثیرگذار خواهند بود. می توانید جهت اطلاع بیشتر از عملکرد سرویسهای فوق الذکر به مستند مربوطه که در زیر آورده شده است مراجعه کنید.
پرداخت هر فاکتور با استفاده از اعتبار از طریق حساب چند امضایی
شماره سرویس: 2775887
همچنین به عنوان نمونه پرداخت فاکتور با استفاده از اعتبار از طریق حساب چند امضایی به صورت زیر است:
جهت توضیحات تکمیلی مراجعه شود به : مستند پرداخت ( سرویس 29821 - پرداخت هر فاکتور با کیف پول )
پارامترهای ورودی
نمونه خروجی
پرداخت فاکتور با استفاده از تسهیلات از طریق حساب چند امضایی
شماره سرویس: 2775888
در صورتی که مشتری توسط کسب و کار صاحب قرارداد تایید گردیده و از طریق سرویس عضویت در قرارداد تسهیلات، عضو قرارداد شده باشد، میتواند با ارسال شناسه فاکتور و شناسه قرارداد در سرویس زیر، نسبت به پرداخت اقساطی فاکتور خود اقدام نماید به شرط آنکه فاکتور در شرایط قرارداد صدق نماید.
در هنگام پرداخت فاکتور مشتری میتواند مبلغ پیش پرداخت را به میزان دلخواه افزایش دهد تا از تسهیلات کمتری استفاده نماید. هم چنین میتواند دوره تنفس طرح بازپرداخت را مشخص نماید، در صورت وارد نکردن مقادیر پارامترهای breathingPeriodType و breathingPeriodCount، تاریخ سرررسید اقساط از همان روز ایجاد تسهیلات محاسبه خواهد گردید.
لازم به ذکر است، امکان ارسال لیستی از وثایق برای مشتری در این سرویس فراهم گردیده است.
کد خطاهای احتمالی در این سرویس، به شرح زیر می باشد.
جهت توضیحات تکمیلی مراجعه شود به : مستند تسهیلات/ پرداخت اقساطی سرویس 1362771 (پرداخت فاکتور با استفاده از تسهیلات)
پارامترهای ورودی
جدول خطا معمول
کد خطا | پیام خطا |
193 | شناسه طرح فروش اقساطی را وارد نمایید. |
4 | اجازه پرداخت این فاکتور را ندارید. (فاکتور برای این مشتری صادر نشده است) |
259 | مبلغ مورد نظر برای ضمانت از سقف اعتبار اعطاشده بیشتر می باشد. (اعتبار مشتری برای دریافت تسهیلات کافی نمیباشد) |
12 | اعتبار کافی جهت پرداخت این فاکتور را ندارید. (مبلغ انتخابی برای بخش نقدی در کیف پول موجود نیست) |
37 | کد وارد شده اشتباه است: XXX (ورودی breathingPeriodType مقدار اشتباه دارد) |
234 | مبلغ پیش پرداخت جدید نمی تواند از حداقل مبلغ پیش پرداخت کمتر باشد. (در صورتی که طرح دارای پیش پرداخت باشد، قسمت نقدی یا primaryAmount باید بزرگتر مساوی پیش پرداخت طرح باشد.) |
101 | به دلیل عدم تنظیم دوره تنفس در قرارداد، امکان تنظیم دوره تنفس وجود ندارد. |
78 | قرارداد تسهیلات اقساطی با شناسه X یافت نشد. LoanPlan با شناسه X وجود ندارد. |
295 | مشتری مجاز به استفاده از این قرارداد تسهیلات نمی باشد. (مشتری عضو قرارداد نیست) |
165 | امکان استفاده از این طرح را در این قرارداد ندارید. (طرح انتخابی مربوط به قرارداد انتخابی نمیباشد) |
پرداخت فاکتور در آینده از طریق حساب چند امضایی
شماره سرویس: 2775889
از طریق این سرویس کسب و کار قادر خواهد بود فاکتورهایی که برایش توسط دیگران صادر شده را درتاریخ آینده یا سررسید توافقی از طریق مبلغی که در کیف پول یا اصناف خود دارد پرداخت نماید .
این سرویس باید توسط کسب و کار یا کاربر بدهکار یا شخصی که فاکتور برایش صادر شده صدا زده شود در غیر این صورت با خطای زیر روبرو خواهد شد.
جهت توضیحات تکمیلی مراجعه شود به : مستند پرداخت ، سرویس 29802 ( پرداخت فاکتور، در آینده)
پارامترهای ورودی
پرداخت فاکتور با استفاده از فاکتور از طربق حساب چند امضایی
شماره سرویس: 2775890
از طریق این سرویس کسب و کار قادر خواهد بود که پرداخت شدن برخی فاکتورهای خود را منوط به پرداخت شدن فاکتورهای دیگری نماید. یا به عبارتی نوعی تهاتر را بوسیله فاکتورها انجام دهد که این امر توسط سرویس زیر قابل اجرا خواهد بود
جهت توضیحات تکمیلی مراجعه شود به : مستند پرداخت ، سرویس 29800 (پرداخت فاکتور، از طریق فاکتور)
پارامترهای ورودی
انتقال اعتبار
در یک حساب چند امضایی درخواست دهنده (ایجادکننده) میتواند نسبت به ثبت یک درخواست انتقال اعتبار اقدام نماید. در یک حساب چند امضایی مشخص، فقط کاربرانی میتوانند درخواست تراکنش مالی ثبت کنند که از قبل در آن حساب به عنوان کاربر ایجاد کننده تعریف شده باشند. سرویسهای مربوط هر کدام از انواع تراکنشها در لینکهای زیر قابل مشاهده است. در این سرویسها مطابق با سرویس اصلی برای تراکنشها، عملیات انجام خواهد گرفت با این تفاوت که سه پارامتر زیر در این سرویسها نسبت به سرویس اصلی افزوده شده است که منجر میشود عملیات بر روی حساب چند امضایی مد نظر اجرا شود.
نحوه عملکرد این سرویس ها مشابه با سرویس های مربوط به حساب های غیر چندامضایی است با این تفاوت که اطلاعات مربوط به حساب و افراد تعریف شده در فرآیند به صورت چند امضایی (کارتابلی) تاثیرگذار خواهند بود. می توانید جهت اطلاع بیشتر از عملکرد سرویسهای فوق الذکر به مستند مربوطه که در زیر آورده شده است مراجعه کنید.
مشتریان یا دنبال کنندگان کسب و کار از گروه های زیر تشکیل می شوند:
همان مشتریان او هستند که پس از صدور فاکتور (چه پرداخت شود یا نشود) دنبال کننده می شوند.
کسب و کارهایی که توسط یک کسب و کار دیگر ایجاد می شوند.
کاربرانی که از درگاه های معرفی کسب و کارها خودشان کسب و کار را دنبال می کنند.
کابرانی که اطلاعات آنها توسط کسب و کار ثبت می شود
همچنین به عنوان نمونه سرویس انتقال اعتبار از حساب کسب و کار به مشتری با توجه به فاکتور مربوطه برای حساب چندامضایی به صورت زیر است:
انتقال اعتبار از حساب کسب و کار به مشتری با توجه به فاکتور برای حساب چند امضایی
شماره سرویس: 2775891
انتقال وجه به مشتریان بر اساس فاکتور:
این سرویس در شرایطی فراخوانی میگردد که نیاز است مبلغی با توجه به فاکتور صادر شده، از کسب و کار به مشتری منتقل گردد. اگر فاکتور ارسالی، هنوز بسته نشده باشد نمیتوانید این سرویس را فراخوانی نمایید و برای تغییر مبلغ فاکتور، لازم است فاکتور را کنسل نموده و مجددا به مبلغ دلخواه فاکتور را صادر نمایید.
اگر فاکتور متعلق به صاحب توکن نباشد، "پیغام مجوز ندارید" دریافت خواهید کرد.
این انتقال مبلغ میتواند از حساب مشتری(کیف پول پاد) و یا از صنف کسب و کار در صورتی که مبلغ قابل تسویه داشته باشد، انجام گیرد.
اگر direct debit فعال باشد، به طور اتومات از حساب اصلی کسر خواهد شد.
نحوه انتقال پول، بر اساس نحوه پرداخت فاکتور ارسالی، خواهد بود. به عنوان مثال، اگر پرداخت فاکتور به صورت نقدی بوده است، انتقال به مشتری با فراخوانی این سرویس ممکن نخواهد بود و در ریسپانس دریافتی از فراخوانی سرویس، همان مبلغ موجود در حساب کسب و کار(کیف پول و صنفی) برگردانده خواهد شد.
برای توضیحات بیشتر مراجعه شود به : مستند حساب دیجیتال سرویس 34988 (انتقال وجه به مشتریان براساس فاکتور )
پارامترهای ورودی
نمونه خروجی
انتقال اعتبار بین حسابهای کاربر از طریق حساب چند امضایی
شماره سرویس: 2775892
کسب و کار بایستی سرویس زیر را برای این منظور صدا بزند. دقت نمایید که مبالغی که منتقل میشوند باید تراز باشند، یعنی جمع مقادیر صفر شود. در شبه کد زیر، اعتبار از حساب صنفی به حساب کیف پول کسب و کار منتقل میگردد.
لازم به ذکر است، فیلد amount نمایانگر مبالغ مربوط به بندهای سند حساب صنفی کسب و کار است و درفیلد customerAmount مبلغ مربوط به بند سند حساب کیف پول وارد میگردد.
لازم به ذکر است، در صورت ارسال uniqueId تکراری توسط کسب و کار، خطای تکراری بودن uniqueId دریافت میگردد و انجام تراکنش تکراری امکانپذیر نمیباشد.
انتقال اعتبار بین حساب های کاربر - در این سرویس مبلغ مثبت به معنی واریز به آن حساب و مبلغ منفی به معنی برداشت از آن حساب می باشد. همچنین تراز بودن سند به عهده شما می باشد
برای توضیحات بیشتر مراجعه شود به : مستند حساب دیجیتال سرویس 34978 (انتقال وجه میان حساب مجازی کسب و کار و کیف پول همان کاربر)
پارامترهای ورودی
نمونه خروجی
انتقال اعتبار از حساب کسب و کار به مشتری آن از طریق حساب چند امضایی
شماره سرویس: 2775893
برای توضیحات بیشتر مراجعه شود به : مستند حساب دیجیتال سرویس 34985 (انتقال وجه به مشتریان)
پارامترهای ورودی
انتقال اعتبار به مخاطب از طریق حساب چند امضایی
شماره سرویس: 2775894
کاربر میتواند مبلغی از اعتبار موجود در کیف پول خود را به کاربر دیگر که لازم است جزء مخاطبین او باشد، انتقال دهد. ثبت مخاطبان کاربر از طریق شماره موبایل یا ایمیل یا نام کاربری یا همه آنها صورت میگیرد. سپس از طریق سرویس زیر امکان انتقال وجه به مخاطب برای کاربر فراهم میگردد .
توجه شود در این سرویس نیازی به کلید خصوصی و ایجاد امضای دیجیتال وجود ندارد.
پارامترهای ورودی
برداشت اعتبار
در یک حساب چند امضایی درخواست دهنده (ایجادکننده) میتواند نسبت به ثبت یک درخواست برداشت اعتبار اقدام نماید. در یک حساب چند امضایی مشخص، فقط کاربرانی میتوانند درخواست تراکنش مالی ثبت کنند که از قبل در آن حساب به عنوان کاربر ایجاد کننده تعریف شده باشند. سرویسهای مربوط هر کدام از انواع تراکنشها در لینکهای زیر قابل مشاهده است. در این سرویسها مطابق با سرویس اصلی برای تراکنشها، عملیات انجام خواهد گرفت با این تفاوت که سه پارامتر زیر در این سرویسها نسبت به سرویس اصلی افزوده شده است که منجر میشود عملیات بر روی حساب چند امضایی مد نظر اجرا شود.
نحوه عملکرد این سرویس ها مشابه با سرویس های مربوط به حساب های غیر چندامضایی است با این تفاوت که اطلاعات مربوط به حساب و افراد تعریف شده در فرآیند به صورت چندامضایی (کارتابلی) تاثیرگذار خواهند بود. می توانید جهت اطلاع بیشتر از عملکرد سرویسهای فوق الذکر به مستندات مربوطه که در زیر آورده شده است مراجعه کنید.
درخواست برداشت اعتبار با استفاده از ابزار در حساب چند امضایی
شماره سرویس: 2775895
برای توضیحات بیشتر مراجعه شود به : مستند تسویه حساب دیجتیال ، سرویس 2467367 ( برداشت از حساب دیجیتال با انتخاب روش انتقال (ابزار)
پارامترهای ورودی
درخواست برداشت اعتبار با فاکتور در حساب چند امضایی
شماره سرویس: 2775896
در این سرویس از شناسه فاکتور جهت برداشت مبلغ موردنظر استفاده میشود.
اگر فاکتور بسته شده باشد و تسویه شاپرکی آن آماده باشد ، امکان برداشت وجود خواهد داشت.
پارامترهای ورودی
درخواست برداشت اعتبار توسط ابزار در حساب چند امضایی
شماره سرویس: 2775897
برای اطلاعات بیشتر مراجعه شود به : مستند تسویه حساب دیجیتال سرویس 2433635 برداشت از حساب تفصیلی با انتخاب روش انتقال (ابزار)
پارامترهای ورودی
تخصیص اعتبار
در یک حساب چند امضایی درخواست دهنده (ایجادکننده) میتواند نسبت به ثبت یک درخواست تفویض اعتبار اقدام نماید. در یک حساب چند امضایی مشخص، فقط کاربرانی میتوانند درخواست ثبت کنند که از قبل در آن حساب به عنوان کاربر ایجاد کننده تعریف شده باشند. سرویسهای مربوط هر کدام از انواع تراکنشها در لینکهای زیر قابل مشاهده است. در این سرویسها مطابق با سرویس اصلی در حسابهای حالت نرمال (غیرچندامضایی) عملیات انجام خواهد گرفت با این تفاوت که سه پارامتر زیر در این سرویسها نسبت به سرویس اصلی افزوده شده است که منجر میشود عملیات بر روی حساب چند امضایی مد نظر اجرا شود.
نحوه عملکرد این سرویس ها مشابه با سرویس های مربوط به حساب های غیر چندامضایی است با این تفاوت که اطلاعات مربوط به حساب و افراد تعریف شده در فرآیند به صورت چند امضایی (کارتابلی) تاثیرگذار خواهند بود. می توانید جهت اطلاع بیشتر از عملکرد سرویسهای فوق الذکر به مستند مربوطه که در زیر آورده شده است مراجعه کنید.
سرویسهای اشاره شده شامل موارد زیر میباشند:
درخواست تفویض (تخصیص) اعتبار از طریق حساب چند امضایی
شماره سرویس: 2775898
برای توضیحات بیشتر مراجعه شود به : مستند اعتبار اختصاصی سرویس 360401 (تخصیص اعتبار خرید به کاربر)
پارامترهای ورودی
درخواست افزایش/کاهش تفویض اعتبار از طریق حساب چند امضایی
شماره سرویس: 2775899
برای توضیحات بیشتر مراجعه شود به : مستند اعتبار اختصاصی سرویس 1192847 (افزایش و یا کاهش اعتبار خرید کاربر )
پارامترهای ورودی
بن اعتباری و بن تخفیف
در یک حساب چند امضایی درخواست دهنده (ایجادکننده) میتواند نسبت به تعریف و ثبت یک بناعتباری اقدام نماید. در یک حساب چند امضایی مشخص، فقط کاربرانی میتوانند درخواست تراکنش مالی ثبت کنند که از قبل در آن حساب به عنوان کاربر ایجاد کننده تعریف شده باشند. سرویسهای مربوط هر کدام از انواع تراکنشها در لینکهای زیر قابل مشاهده است. در این سرویسها مطابق با سرویس اصلی برای تراکنشها، عملیات انجام خواهد گرفت با این تفاوت که سه پارامتر زیر در این سرویسها نسبت به سرویس اصلی افزوده شده است که منجر میشود عملیات بر روی حساب چند امضایی مد نظر اجرا شود.
نحوه عملکرد این سرویس ها مشابه با سرویس های مربوط به حساب های غیر چندامضایی است با این تفاوت که اطلاعات مربوط به حساب و افراد تعریف شده در فرآیند به صورت چند امضایی (کارتابلی) تاثیرگذار خواهند بود. می توانید جهت اطلاع بیشتر از عملکرد سرویسهای فوق الذکر به مستندات مربوطه که در زیر آورده شده است مراجعه کنید.
تعریف بن اعتباری از طرف کابر طریق حساب چند امضایی
شماره سرویس: 2775900
جهت تعریف شارژ اعتبار از طرف کاربر، از سرویس زیر استفاده نمایید:
پس از تعریف بن شارژ اعتباری از طرف کاربر، مبلغ مورد نظر در کیف پول کاربر مسدود میگردد. در صورت غیرفعالسازی و یا منقضی شدن اعتبار، مبلغ مسدود شده به کیف پول کاربر برگردانده میشود.
لازم به ذکر است در صورتی که بخواهید بن شارژ فقط برای کاربر مشخص قابل استفاده باشد، بایستی شناسه کاربری مورد نظر را در فیلد limitedConsumerId وارد نمایید.
توجه داشته باشید به ازای هر بن شارژ، باید مقادیر تعداد، مبلغ، نام و توضیحات در پارامترهای جداگانه ارسال گردند. همچنین میتوانید کد هش را به صورت دلخواه تعریف نمایید، در این صورت لازم است به ازاء هر بن کارت hash مورد نظر وارد گردد.
لازم به ذکر است، می توانید 5 حرف را در ابتدای کد هش برای کسب و کار خود رزرو نمایید تا کسب و کارهای دیگر مجاز به استفاده از این حروف در ابتدای کد هش خود نباشند.
پارامترهای ورودی
درخواست تعریف بن اعتباری از طرف کسب و کار از طریق حساب چند امضایی
شماره سرویس: 2775901
جهت تعریف شارژ اعتبار از طرف کسب و کار، سرویس زیر را فراخوانی نمایید:
برای تعریف بن شارژ اعتبار، بایستی در حساب خود اعتبار داشته باشید. همچنین در صورتی که بخواهید بن شارژ فقط برای کاربر مشخص قابل استفاده باشد، بایستی شناسه کاربری مورد نظر را در فیلد limitedConsumerId وارد نمایید.
با فراخوانی سرویس فوق و ایجاد بن شارژ کیف پول، مبلغ مربوط به آنها مسدود شده و تا زمان مصرف توسط مشتری یا غیر فعال شدن توسط صادر کننده، مبلغ آن مسدود می ماند
توجه داشته باشید به ازای هر بن شارژ، باید مقادیر تعداد، مبلغ، نام و توضیحات در پارامترهای جداگانه ارسال گردند. همچنین میتوانید کد هش را به صورت دلخواه تعریف نمایید، در این صورت لازم است به ازاء هر بن کارت hash مورد نظر وارد گردد.
لازم به ذکر است، می توانید 5 حرف را در ابتدای کد هش برای کسب و کار خود رزرو نمایید تا کسب و کارهای دیگر مجاز به استفاده از این حروف در ابتدای کد هش خود نباشند.
پارامترهای ورودی
تعریف بن تخفیف مبلغی از طریق حسبا چند امضایی
شماره سرویس: 2775902
برای ساخت بن تخفیف با مبلغ مشخص، سرویس زیر را فراخوانی نمایید. میتوانید با یک بار فراخوانی سرویس، برای چند کاربر اعتبار تعریف نمایید
نکته قابل توجه این است که به ازای هر کاربر، کد هش متفاوتی دریافت خواهید کرد و مشتری با اعمال کد هش امکان استفاده از شارژ تعریف شده را خواهد داشت.
در تعریف بن تخفیف مبلغی، GuildCode بهعنوان حوزهی مصرف بن اجباری است.
توجه داشته باشید به ازای هر بن تخفیف، بایستی مقادیر تعداد، مبلغ، نام و توضیحات در پارامترهای جداگانه ارسال گردند. همچنین میتوانید hash code را به صورت دلخواه تعریف نمایید، در این صورت لازم است به ازاء هر بن کارت، hash مورد نظر وارد گردد.
در صورتی که میخواهید یک hash code به صورت عمومی تعریف شده و به تعداد دفعات مشخص برای همه کاربران قابل استفاده باشد، لازم است که تعداد دفعات مورد نظر، جهت استفاده از ووچر را در پارامتر perUserUsageLimitCount ارسال نمایید. در این صورت استفاده از این hash code برای همه کاربران، به تعداد دفعات وارد شده امکانپذیر خواهد بود.
لازم به ذکر است،کسب و کار می تواند 5 حرف را در ابتدای hash code به صورت انحصاری برای خود رزرو نمایید و کسب و کارهای دیگر مجاز به استفاده از این حروف در ابتدای hash code خود نباشند.
پارامترهای ورودی
guildCode | * | نام صنف مطابق با صنف موجود در پنل |
expireDate | * | تاریخ انقضای شمسی با فرمت yyyy/mm/dd |
[]count | * | لیست تعداد بن تخفیف |
[]amount | * | لیست مبالغ بن تخفیف |
[]productId |
| لیست محصولات |
[]dealerBusinessId |
| لیست شناسه کسب وکارهای واسط کسب وکار اصلی که میتوانند از این بن تخفیف هنگام صدور فاکتور استفاده کنند. |
[]name | * | لیست نام ها |
[]description | * | توضیحات بن تخفیف |
limitedConsumerId |
| در صورت ورود شناسه کاربری، بن تخفیف فقط برای کاربر داده شده قابل استفاده خواهد بود. |
currencyCode |
| کد ارز - مقدار پیش فرض IRR |
[]hash |
| میتوانید کد هش دلخواه خود را تنظیم نمایید. |
[]effectiveDates |
| لیست تاریخ موثر ووچر است. چنانچه تاریخ موثر برای بن تخفیف ثبت گردد، بن تخفیف از تاریخ تعیین شده قابل استفاده خواهد بود و قبل از آن تاریخ، استفاده از بن تخفیف امکانپذیر نخواهد بود. |
[]minInvoiceItemCount |
| لیست حداقل بند فاکتور برای اعمال ووچر است. در صورت ارسال این پارامتر، بن تخفیف تنها در صورتی قابل استفاده خواهد بود که تعداد بند فاکتور صادر شده، بزرگتر مساوی مقادیر وارد شده باشد. |
[]minInvoiceAmount |
| لیست حداقل مبلغ فاکتور برای اعمال ووچر است. در صورت ارسال این پارامتر، بن تخفیف تنها در صورتی قابل استفاده خواهد بود که مبلغ فاکتور صادر شده، بزرگتر مساوی مقادیر وارد شده باشد. |
[]perUserUsageLimitCount |
| تعداد دفعات مجاز استفاده از ووچر به ازای هر کاربر (بزرگتر و یا مساوی با 1) |
uniqueId |
| شناسه منحصر لیست ووچرهای ثبت شده در یک زمان |
attTemplateCode |
| کد دسته مشخصه محصول |
attCode |
| لیست کد مشخصه های محصول بر اساس دسته مشخصه یا گروه محصول |
attValue |
| لیست مقدار مشخصه ها |
تعریف بن تخفیف درصدی از طریق حساب چند امضایی
شماره سرویس: 2775903
به منظور تعریف کد بن تخفیف در قالب درصدی، سرویس زیر را فراخوانی نمایید:
در تعریف بن تخفیف درصدی، GuildCode بهعنوان حوزهی مصرف بن اجباری است.
توجه داشته باشید به ازای هر بن شارژ، باید مقادیر تعداد، مبلغ، نام و توضیحات در پارامترهای جداگانه ارسال گردند. همچنین میتوانید کد هش را به صورت دلخواه تعریف نمایید، در این صورت لازم است به ازاء هر بن کارت hash مورد نظر وارد گردد.
در صورتی که میخواهید یک هش کد به صورت عمومی تعریف شده و به تعداد دفعات مشخص برای همه کاربران قابل استفاده باشد، بایستی تعداد دفعات مورد نظر، جهت استفاده از بن تخفیف را در پارامتر perUserUsageLimitCount ارسال نمایید. در این حالت استفاده از این هش کد برای همه کاربران، به تعداد دفعات وارد شده امکانپذیر خواهد بود. لازم به ذکر است، بایستی حتما بن تخفیف به صورت بدون محدودیت تعریف گردد و مقدار پارامتر type برابر با 8 خواهد بود.
توجه نمایید، چنانچه در هنگام تعریف بنهای تخفیف درصدی بدون محدودیت، پارامتر perUserUsageLimitCount ارسال گردد، بن تخفیف قابلیت استفاده به دفعات نامحدود را نخواهد داشت و به تعداد دفعات وارد شده، برای هر کاربر قابل استفاده خواهد بود.
در صورت تعیین سقف مبلغ برای بن درصدی، در صورتی که بن بیش از یکبار قابل استفاده باشد، در دفعات بعدی مبلغ باقیمانده نسبت به سقف تعیین شده، قابل استفاده است.
لازم به ذکر است، می توانید 5 حرف را در ابتدای کد هش برای کسب و کار خود رزرو نمایید تا کسب و کارهای دیگر مجاز به استفاده از این حروف در ابتدای کد هش خود نباشند.
در بخش زیر جدول راهنمای استفاده از انواع Typeهای بن تخفیف درصدی ارائه شده است. همچنین حالتهای مختلف ارسال یا عدم ارسال مقادیر productId و limitedConsumerId نیز توضیح داده شده است.
پارامترهای ورودی
guildCode | * | نام صنف مطابق با صنف موجود در پنل |
expireDate | * | تاریخ انقضای شمسی با فرمت yyyy/mm/dd |
[]count | * | لیست تعداد بن تخفیف |
[]amount |
| سقف مبلغ قابل استفاده از بن، در صورتی که صفر باشد یا وارد نشود فقط تخفیف درصدی بدون سقف اعمال میشود. |
[]discountPercentage | * | لیست درصدهای بن تخفیف |
[]name | * | لیست نامها |
[]productId |
| لیست شناسه محصولات، بن تخفیف فقط برای این محصولات در صورت وجود در فاکتور قابل استفاده خواهد بود. |
[]dealerBusinessId |
| در صورتی که کسب و کار فروشندگانی دارد که میخواهد آنها نیز بتوانند بن تخفیف را در فاکتورهای فروش خود اعمال نمایند، لازم است شناسه ی آنها را در این بن ها ثبت نماید. در صورتی که مصرف بن به یک یا چند محصول محدود شود، لازم است مجوز فروش محصول نیز به فروشندگان داده شود. |
[]description | * | توضیحات بن تخفیف |
limitedConsumerId |
| در صورت ورود شناسه کاربری، بن تخفیف فقط برای کاربر داده شده قابل استفاده خواهد بود. |
currencyCode |
| کد ارز - مقدار پیش فرض IRR |
[]hash |
| میتوانید کد هش دلخواه خود را تنظیم نمایید. این پارامتر باید به تعداد مجموع count[] ها ارسال شود. یعنی نام هر بن تخفیفی که تولید میشود مشخص باشد یا اصلاً ارسال نشود. |
type | * | این مقدار میتواند یکی از مقادیر 4(یکبار مصرف برای یک آیتم)، 8(بدون محدودیت) و 16(یکبار مصرف برای یک فاکتور) باشد. |
[]effectiveDates |
| لیست تاریخ موثر بن تخفیف است. چنانچه تاریخ موثر برای بن تخفیف ثبت گردد، بن تخفیف از تاریخ تعیین شده قابل استفاده خواهد بود و قبل از آن تاریخ، استفاده از بن تخفیف امکانپذیر نخواهد بود. |
[]minInvoiceItemCount |
| لیست حداقل بند فاکتور برای اعمال بن تخفیف است. در صورت ارسال این پارامتر، بن تخفیف تنها در صورتی قابل استفاده خواهد بود که تعداد بند فاکتور صادر شده، بزرگتر مساوی مقادیر وارد شده باشد. |
[]minInvoiceAmount |
| لیست حداقل مبلغ فاکتور برای اعمال بن تخفیف است. در صورت ارسال این پارامتر، بن تخفیف تنها در صورتی قابل استفاده خواهد بود که مبلغ فاکتور صادر شده، بزرگتر مساوی مقادیر وارد شده باشد. |
[]perUserUsageLimitCount |
| تعداد دفعات مجاز استفاده از بن تخفیف به ازای هر کاربر (بزرگتر و یا مساوی با یک) |
uniqueId |
| شناسه منحصر لیست ووچر های ثبت شده در یک زمان |
دریافت گزارش از تراکنشها
دریافت اطلاعات یک تراکنش چند امضایی توسط کسب و کار
در این سرویس کلیه اطلاعات مربوط به یک تراکنش چند امضایی مطابق با پارامترهای زیر توسط کسب و کار قابل دستیابی است. با استفاده از این سرویس میتوانید آخرین وضعیت تراکنش را بررسی نمایید؛ شامل اینکه چه کسانی تراکنش را باید تایید کنند، چه کسانی هنوز تراکنش را تایید نکردهاند، آخرین وضعیت تراکنش و ... . همچنین این امکان برای کسب و کار وجود دارد تا گزارشی از تراکنشهای حساب چند امضایی خود متناسب با فیلترهای مد نظرش (پارامترهای زیر) مشاهده نماید.
پارامترهای ورودی
توضیح سایر پارامترها:
Description | Name |
شناسه کارتابل | cartableId |
شناسه درخواست | requestId |
شناسه کاربر درخواست دهنده | requesterUserIds |
شناسه کاربر/ کاربران تایید کننده | confirmerUserIds |
کد نوع تراکنش MULTI_CONFIRMATION_TYPE_INVOICE, MULTI_CONFIRMATION_TYPE_DELEGATION_RULE, MULTI_CONFIRMATION_TYPE_AMOUNT_VOUCHER, MULTI_CONFIRMATION_TYPE_PERCENT_VOUCHER, MULTI_CONFIRMATION_TYPE_TRANSFER, MULTI_CONFIRMATION_TYPE_SETTLEMENT, MULTI_CONFIRMATION_TYPE_VOUCHER | requestTypeCode |
کد وضعیت درخواست CARTABLE_REQUEST_WAITING, CARTABLE_REQUEST_CONFIRMED, CARTABLE_REQUEST_FINALIZED, CARTABLE_REQUEST_CANCELED, CARTABLE_REQUEST_REJECTED, CARTABLE_REQUEST_FAILED, CARTABLE_REQUEST_EXPIRED | status |
شناسه کاربر در انتظار تایید درخواست | pendingUserId |
کد یکتای درخواست | uniqueId |
توضیحات درخواست | description |
از تاریخ | fromDate |
تا تاریخ | toDate |
result offset | *offset |
result size | *size |
نمونه خروجی
json
دریافت اطلاعات یک تراکنش چند امضایی توسط کاربر(دریافت لیست درخواستهای کارتابل برای کاربر)
شماره سرویس: 2775905
در این سرویس کلیه اطلاعات مربوط به یک تراکنش چند امضایی مطابق با پارامترهای زیر توسط کاربر قابل دستیابی است.
پارامترهای ورودی
جدول توضیح پارامترها:
توضیح | نام پارامتر |
شناسه کارتابل | cartableId |
شناسه درخواست | requestId |
شناسه کاربر درخواست دهنده | requesterUserIds |
شناسه کاربر/ کاربران تایید کننده | confirmerUserIds |
کد نوع تراکنش MULTI_CONFIRMATION_TYPE_INVOICE, MULTI_CONFIRMATION_TYPE_DELEGATION_RULE, MULTI_CONFIRMATION_TYPE_AMOUNT_VOUCHER, MULTI_CONFIRMATION_TYPE_PERCENT_VOUCHER, MULTI_CONFIRMATION_TYPE_TRANSFER, MULTI_CONFIRMATION_TYPE_SETTLEMENT, MULTI_CONFIRMATION_TYPE_VOUCHER | requestTypeCode |
کد وضعیت درخواست CARTABLE_REQUEST_WAITING, CARTABLE_REQUEST_CONFIRMED, CARTABLE_REQUEST_FINALIZED, CARTABLE_REQUEST_CANCELED, CARTABLE_REQUEST_REJECTED, CARTABLE_REQUEST_FAILED, CARTABLE_REQUEST_EXPIRED | status |
شناسه کاربر در انتظار تایید درخواست | pendingUserId |
کد یکتای درخواست | uniqueId |
توضیحات درخواست | description |
از تاریخ | fromDate |
تا تاریخ | toDate |
result offset | *offset |
result size | *size |
نمونه خروجی
دریافت اطلاعات یک تراکنش چند امضایی توسط کاربرهای ایجاد کننده یا تایید کننده
شماره سرویس: 2775906
در این سرویس کلیه اطلاعات مربوط به یک تراکنش چند امضایی مطابق با پارامترهای زیر توسط کاربرهای ایجاد کننده و تایید کننده تراکنش قابل دستیابی است. این سرویس برای دسترسی کاربران ایجاد کننده و تایید کننده تراکنشها طراحی شده است.
پارامتر ورودی
جدول پارامترها:
توضیح | نام پارامتر |
شناسه کارتابل | cartableId |
شناسه درخواست | requestId |
شناسه کاربر حساب مبدا | UserId |
شناسه کسب و کار حساب مبدا | businesIds |
کد نوع تراکنش MULTI_CONFIRMATION_TYPE_INVOICE, MULTI_CONFIRMATION_TYPE_DELEGATION_RULE, MULTI_CONFIRMATION_TYPE_AMOUNT_VOUCHER, MULTI_CONFIRMATION_TYPE_PERCENT_VOUCHER, MULTI_CONFIRMATION_TYPE_TRANSFER, MULTI_CONFIRMATION_TYPE_SETTLEMENT, MULTI_CONFIRMATION_TYPE_VOUCHER | requestTypeCode |
کد وضعیت درخواست CARTABLE_REQUEST_WAITING, CARTABLE_REQUEST_CONFIRMED, CARTABLE_REQUEST_FINALIZED, CARTABLE_REQUEST_CANCELED, CARTABLE_REQUEST_REJECTED, CARTABLE_REQUEST_FAILED, CARTABLE_REQUEST_EXPIRED | status |
شناسه کاربر در انتظار تایید درخواست | pendingUserId |
کد یکتای درخواست | uniqueId |
توضیحات درخواست | description |
از تاریخ | fromDate |
تا تاریخ | toDate |
result offset | *offset |
result size | *size |
نمونه خروجی
دریافت گزارش از حساب
نجایی که هر کاربر و یا کسب وکار به اطلاعاتی در خصوص حسابهای چند امضایی موجود و مرتبط با خودش نیاز دارد، سرویسهایی ارائه شده است تا آنها قادر به دریافت اطلاعات حسابهای چند امضایی خودشان مطابق پارامترهای تعریف شده باشند؛ شامل اینکه چه حساب های دارند، در چه حسابهای تایید کننده هستند، در چه حسابهایی امکان تعریف درخواست دارند و ...
لیست حسابها برای کسب و کار
شماره سرویس: 2775907
پارامتر ورودی
جدول پارامترها:
Description | Name |
شناسه کارتابل | cartableId |
کد صنف تفویض | guildCode |
وضعیت کارتابل true/false | enable |
MULTI_CONFIRMATIOM_VERIFY_TOOL_API MULTI_CONFIRMATIOM_VERIFY_TOOL_SMS | confirmTool |
کد نوع تایید چند مرحله ای | typeCode |
لیست کارتابلهای کسب و کار true/false | isMyCartable |
کارتابل هایی که در آن تایید کننده هستم true/false | isConfirmer |
کارتابل هایی که میتوانم به آن درخواست ارسال کنم true/false | isRequester |
result offset | *offset |
result size | *size |
نمونه خروجی
لیست حسابها برای کاربر
شماره سرویس: 2775908
پارامتر ورودی
جدول پارامترها:
Description | Name |
شناسه کارتابل | cartableId |
کد صنف تفویض | guildCode |
وضعیت کارتابل true/false | enable |
MULTI_CONFIRMATIOM_VERIFY_TOOL_API MULTI_CONFIRMATIOM_VERIFY_TOOL_SMS | confirmTool |
کد نوع تایید چند مرحله ای | typeCode |
لیست کارتابلهای کسب و کار true/false | isMyCartable |
کارتابل هایی که در آن تایید کننده هستم true/false | isConfirmer |
کارتابل هایی که میتوانم به آن درخواست ارسال کنم true/false | isRequester |
result offset | *offset |
result size | *size |
نمونه خروجی
-
لاگ درخواست یک تراکنش
پس از ایجاد یک درخواست توسط کاربر ایجاد کننده و تایید و یا رد آن توسط تمامی کاربران تاییدکنندگان (کفایت امضا) درخواست مورد نظر در سیکل موجودی حساب قرار گرفته و در صورت موجود نقدینگی لازم عملیات مالی صورت خواهد پذیرفت. با پیشرفت این مراحل و یا در صورت وجود هرگونه خطا در طول این عملیات میتوان به بررسی لاگ مربوطه از طریق سرویسهای زیر پرداخت.
دریافت لاگ درخواست یک تراکنش مالی برای کسب و کار
شماره سرویس: 2775909
پارامتر ورودی
نمونه خروجی
json
دریافت لاگ درخواست یک تراکنش مالی برای کاربر
شماره سرویس: 2775910
پارامتر ورودی