API قرارداد و امضای دیجیتال
API قرارداد دیجیتال بازارپی: قرارداد بسازید، امضاکنندگان آن را به‌صورت دیجیتال امضا کنند و امضا را اعتبارسنجی کنید.
با سرویس قرارداد و امضای دیجیتال بازارپی، قراردادهای خود را بدون کاغذ و مراجعه حضوری امضا می‌کنید: قرارداد را ثبت می‌کنید، امضاکنندگان آن را به‌صورت دیجیتال امضا می‌کنند و امضا قابل اعتبارسنجی است.
ایجاد قرارداد با متد POST به مسیر /mzahub/v1/contracts انجام می‌شود. قراردادهایی که از حساب شما ایجاد میشوند متعلق به حساب شما هستند و استعلام، لغو، دانلود و مراحل امضا فقط برای آن‌ها پاسخ داده می‌شود. ارسال هدر X-REAL-IP لازم نیست؛ درگاه IP ثبتشدهی سرور خودش را ارسال میکند. مهلت پاسخ این سرویس ۱۰۰ ثانیه است.
برای استفاده، در بازارپی ثبت‌نام کنید، سرویس را درخواست دهید و پس از تأیید، کلید API بسازید. یک جفت کلید برای همه سرویس‌ها کار میکند، دسترسی هر کلید را می‌توانید به IP سرورهای خود محدود کنید و با «کلید تست» پاسخ نمونه بدون کسر هزینه بگیرید. هزینه به ریال و فقط برای درخواست‌های موفق از کیف پول (پیش‌پرداخت) یا سقف اعتبار (پس‌پرداخت) کسر می‌شود؛ خطاهای سمت ارائهدهنده (۵xx) هرگز محاسبه نمیشوند.
کاربردها
- امضای قرارداد خدمات یا فروش اقساطی به‌صورت غیرحضوری
- امضای فرم‌ها و تعهدنامه‌های مشتریان
- ترکیب با احراز هویت بایومتریک برای امضای قرارداد پس از تأیید هویت
سرویس‌ها و قیمت
جزئیات کامل درخواست و پاسخ در مرجع API و نحوه دریافت توکن در راهنمای فنی آمده است.
سؤالات متداول
چه کسی به قراردادهای من دسترسی دارد؟
قراردادهایی که از حساب شما ایجاد میشوند متعلق به حساب شما هستند و برای شناسههای دیگر خطای service.not_found برمیگردد.
آیا باید هدر X-REAL-IP بفرستم؟
خیر؛ برای مسیرهای /mzahub درگاه IP ثبتشدهی سرور خودش را بهجای آن ارسال میکند.
هزینه این سرویس چطور محاسبه می‌شود؟
قیمت هر سرویس به ریال در همین صفحه و کاتالوگ آمده است. فقط درخواست‌های موفق (و طبق قوانین هر سرویس) محاسبه میشوند، خطاهای سمت ارائهدهنده و قطعی ارتباط هرگز هزینه ندارند و مالیات بر ارزش افزوده جداگانه در صورتحساب می‌آید.
میتوانم پیش از استفاده واقعی تست کنم؟
بله. با «کلید تست» در پنل، درخواستها همه بررسیهای عادی را میگذرانند اما به ارائهدهنده ارسال نمیشوند؛ پاسخ نمونه با همان ساختار مرجع API برمیگردد و هزینهای کسر نمیشود.