در مطلب قبل در مورد وب سرویس پی‌پینگ چیست؟ توضیح دادیم در این مطلب در مورد وب سرویس پلتفرم مالی پی‌پینگ توضیح خواهیم داد .
مقدمه
تمامی وب سرویس‌های توضیح داده شده در این مستندات به صورت RESTful هستند و طبق همین چهارچوب باید با آنها ارتباط برقرار کرد(وب سرویس پلتفرم مالی پی‌پینگ).
جهت رفع هرگونه مشکل و یا پرسش با پشتیبانی در تماس باشید.
POSTMAN
برای راحتی کار شما فایل postman سرویس ها برای شما آماده شده است که می توانید از لینک زیر آن را دانلود کنید و با استفاده از اپلیکیشن دسکتاپ postman از آن استفاده کنید
توضیحات تکمیلی برای تمام سرویس‌ها
برای فراخوانی سرویس‌های صفحه‌بندی (pagination) اگر پارامتر ورودی ارسال نشود، حداکثر ۱۰ آیتم نمایش داده می‌شود و همچنین حداکثر تعداد دریافت آیتم به ازای هر درخواست ۵۰ عدد می‌باشد و بیشتر از آن را سرویس پشتیبانی نمی‌کند و در صورت نیاز به بارگزاری تمام آیتم‌های یک سرویس به صورت یکجا با ایمیل به بخش پشتیبانی در تماس باشید. همینطور توجه داشته باشین واحد پول در تمام سرویس‌ها تومان می‌باشد و منطقه زمانی تمامی تاریخ و ساعت‌ها برابر با ساعت جهانی یا UTC می‌باشد.
نکاتی برای آپلود فایل‌ها
برای آپلود هرگونه فایل اعم از عکس پروفایل کاربران و یا گزارشات پرداخت‌ها و … می‌بایست که از سرویس بارگذاری فایل استفاده کنید.
پس از انجام عملیات آپلود توسط سرویس بارگذاری فایل، تنها کافیست نام فایل آپلود شده که در خروجی سرویس به شما برگردانده می‌شود را ذخیره نمایید.
جدول کدهای دریافتی از هر سرویس
بعد از ارسال هر درخواست به سمت سرور، از سمت ما طبق قواعد وب‌سرویس‌های RESTful یک کدی به شما بازگرداننده می‌شود. هر کد معنایی دارد که در جدول زیر توضیحات مربوطه را می‌بینید
Authentication
Bearer
برای احراز هویت در سرویس‌های مختلف باید از توکن Bearer در header درخواست‌ها به صورت زیر استفاده کنید
ساختار ارسال توکن: (Bearer TOKEN)
اگر شما یک اپلیکیشن و یا وب‌سایت شخصی دارید و قصد استفاده از سرویس‌های مالی ما را برای خود دارید می‌بایست از access token استفاده کنید
oauth2
Payment
متدهای مرتبط با تراکنش‌های مالی که شامل پرداخت پول، پرداخت تسهیمی و تمام فرآیندهای تایید یک تراکنش می‌باشد.
آزاد سازی پول مسدود شده
به کمک این متد، می توانید پول مسدود شده توسط متد BlockMoney را از حالت مسدودی آزاد نمایید
ساخت پرداخت شناسه دار
از این متد می تواند برای ساخت یک پرادخت شناسه دار که به کمک دستگاه Pos پرداخت آن انجام می شود، استفاده کرد.
برای لغو کردن یک کد پرداخت می توانید از این متد استفاده کنید
در این مطلب در مورد وب سرویس پلتفرم مالی پی‌پینگ توضیح دادیم در مطلب بعد در مورد وب سرویس پلتفرم مالی توضیح خواهیم داد