راهنمای جامع مدیریت پذیرندهها در وبسرویس پرداخت کرایه تاکسی
در دنیای مدرن حملونقل شهری، سیستمهای پرداخت آنلاین نقشی حیاتی دارند. پس از بررسی مقدمات وبسرویس در مقاله پیشین، اکنون نوبت به بررسی دقیق بخش «پذیرنده» (Merchant) میرسد. این بخش ستون فقرات تسویه مالی در سیستمهای تاکسیرانی است. اگر به دنبال پیادهسازی یک درگاه پرداخت هوشمند هستید، مقاله ی دقیقاً وبسرویس پرداخت کرایه تاکسی برای شما نوشته شده است. 🚕
پذیرنده (Merchant) چیست و چه کاربردی دارد؟
پذیرنده در این سیستم، شخص یا نهادی است که دارای شماره شبا است. در واقع، تمام مبالغ پرداختی توسط مسافران به حساب این شخص یا نهاد واریز میشود. بدون تعریف پذیرنده، امکان ایجاد درخواست پرداخت برای شبا وجود نخواهد داشت. این ساختار به شما اجازه میدهد مدیریت دقیق و شفافی بر جریان مالی خود داشته باشید. 💳
مزیتهای استفاده از وبسرویس پرداخت کرایه تاکسی
استفاده از این API مزایای متعددی برای کسبوکارهای حملونقل دارد که عبارتند از:
- ✅ مدیریت متمرکز: امکان تعریف چندین پذیرنده برای یک کسبوکار به صورت همزمان فراهم است.
- ✅ شفافیت مالی: تمام تراکنشها به تفکیک هر پذیرنده قابل ردیابی و مدیریت هستند.
- ✅ امنیت بالا: با استفاده از توکنهای امنیتی، دسترسی به اطلاعات مالی پذیرنده محدود و ایمن شده است.
- ✅ اتوماسیون سریع: فرآیند ثبت و تسویه حسابها بدون نیاز به دخالت انسانی و به صورت آنی انجام میشود.
کاربردهای اصلی این وبسرویس
این سرویس در موارد زیر کاربرد فراوان دارد:
- 🚕 تاکسیهای اینترنتی: مدیریت واریزی به حساب رانندگان به صورت مجزا و کاملاً خودکار.
- 🚚 شرکتهای حملونقل: تعریف پذیرندگان مختلف برای ناوگانهای باری یا مسافربری.
- 🏢 مدیریت ناوگانهای عمومی: امکان تعریف شعب مختلف به عنوان پذیرنده برای گزارشگیری مالی دقیق.
شروع به کار و ثبتنام در سامانه
برای استفاده از این وبسرویس قدرتمند، ابتدا باید در سامانه ثبتنام کنید. مراحل کار بسیار ساده است و شما میتوانید از طریق لینک رسمی p.api.ir اقدام کنید. پس از ثبتنام، کلیدهای دسترسی (API Key) خود را دریافت کرده و آماده فراخوانی متدها شوید. تمامی درخواستهای شما باید با Authorization Code معتبر ارسال شوند. 🚀
مدیریت پذیرندهها: مستندات فنی API
در این بخش، متدهای اصلی برای تعامل با پذیرندهها را بررسی میکنیم. تمام درخواستها باید به سمت سرورهای ما ارسال شوند.
۱. ایجاد یک پذیرنده جدید
برای اتصال یک شماره شبا به سیستم، باید یکبار آن را به عنوان پذیرنده ثبت کنید. اگر تنها از یک پذیرنده استفاده میکنید، شاید نیازی به این کار نباشد. اما برای مدیریت ناوگان، این متد حیاتی است.
درخواست HTTP:
POST https://resid.ir/api/v1/merchants
نمونه دستور CURL:
curl "https://resid.ir/api/v1/merchants" \
-X POST \
-H "Authorization: $AUTHORIZATION_CODE" \
-F logo="@/path/to/logo" \
-d first_name="Asghar" \
-d last_name="Farhadi" \
-d phone_number="09123456789" \
-d national_no="1234567890" \
-d sheba="IR123456789012345678901234" \
-d bank_code=0 \
-d job_title="Programmer"
۲. دریافت اطلاعات یک پذیرنده
با این سرویس، میتوانید جزئیات مربوط به یک پذیرنده خاص را بر اساس شناسه (Slug) دریافت کنید.
درخواست HTTP:
GET https://resid.ir/api/v1/merchants/<merchant_slug>
نمونه دستور CURL:
curl "https://resid.ir/api/v1/merchants/aF1q2FSde2R" \
-X GET \
-H "Authorization: $AUTHORIZATION_CODE"
۳. بهروزرسانی اطلاعات پذیرنده
آیا اطلاعات تماس یا عنوان شغلی پذیرنده تغییر کرده است؟ از متد PATCH برای اعمال تغییرات استفاده کنید.
درخواست HTTP:
PATCH https://resid.ir/api/v1/merchants/<merchant_slug>
نمونه دستور CURL:
curl "https://resid.ir/api/v1/merchants/aF1q2FSde2R" \
-X PATCH \
-H "Authorization: $AUTHORIZATION_CODE" \
-d first_name="Asqar" \
-d last_name="Farhady"
۴. حذف پذیرنده
در صورت عدم نیاز به یک پذیرنده، میتوانید آن را به سادگی حذف کنید. 🗑️
درخواست HTTP:
DELETE https://resid.ir/api/v1/merchants/<merchant_slug>
نمونه دستور CURL:
curl "https://resid.ir/api/v1/merchants/aF1q2FSde2R" \
-X DELETE \
-H "Authorization: $AUTHORIZATION_CODE"
۵. دریافت لیست تمامی پذیرندهها
این متد به شما کمک میکند لیستی از تمام پذیرندههای ثبتشده توسط کسبوکار خود را مشاهده کنید. این متد از پارامترهای offset و size برای صفحهبندی استفاده میکند. 📋
درخواست HTTP:
GET https://resid.ir/api/v1/merchants?offset=20&size=10
نکات امنیتی برای توسعهدهندگان
هنگام کار با APIها، امنیت اولویت اول است. هرگز Authorization Code خود را در کدهای سمت کلاینت (مانند JavaScript عمومی) قرار ندهید. همیشه درخواستها را از سمت سرور خود ارسال کنید تا کلیدهای دسترسی فاش نشوند. همچنین، همیشه پاسخهای API را برای مدیریت خطاهای احتمالی (مانند کد ۴۰۱ یا ۴۰۳) بررسی کنید. 🔐
قدم آخر
مدیریت پذیرندهها سنگ بنای یک سیستم پرداخت موفق در پروژههای حملونقل است. با استفاده از متدهایی که آموزش دادیم، شما کنترل کاملی بر جریان مالی و هویت پذیرندگان خود خواهید داشت. اگر سوالی در مورد پیادهسازی دارید، حتماً در بخش نظرات بپرسید. برای یادگیری نحوه ایجاد تراکنش و عملیات پرداخت، پیشنهاد میکنیم مقاله بعدی ما درباره «وبسرویس پرداخت» را نیز مطالعه کنید. 📚
آمادهاید شروع کنید؟ همین حالا در p.api.ir ثبتنام کرده و پیادهسازی را آغاز کنید.