کیف پرتال (Wallet)
آیپیهای هُما برای اعلام به بانک / PSP
برای فراخوانی، Call Back و سایر سرویسهای این بخش، اعلام همین دو آیپی به بانک کافی است:
| # | آیپی | دامنه | پورت | توضیح |
|---|---|---|---|---|
| ۱ | 81.12.30.43 | https://www.homacrm.com | 443 | سرور هُما — اعلام به بانک |
| ۲ | 134.255.200.130 | https://api.homais.com | 443 | API / Call Back هُما — اعلام به بانک |
همین دو آیپی برای تمام سرویسهای پرداخت این بخش کافی است؛ آیپی دیگری لازم نیست.
باز کردن: از داشبورد روی کارت Wallet / کیف پرتال کلیک کنید؛ مودال «Portal Wallet» باز میشود.
تب گردش کیف پول: کارت مانده (ریال و معادل تومان)، دکمهٔ شارژ که مودال شارژ را باز میکند، بخش فیلتر تراکنشها (دسته، نوع، بازهٔ تاریخ، تراکنش سیستمی و …)، و جدول ریز تراکنشها با صفحهبندی. در هدر مودال، وقتی این تب فعال است، دکمهٔ Refresh مانده و لیست را از سرور تازه میکند.
تب درگاههای پرداخت: افزودن، ویرایش یا مدیریت درگاههایی که مشتریان/پرتال برای پرداخت استفاده میکنند؛ تعداد درگاهها در برچسب تب نمایش داده میشود.
تب تراکنشهای درگاه: فقط وقتی نمایش داده میشود که حداقل یک درگاه تعریف شده باشد؛ جزئیات پرداختهای عبوری از درگاه را میبینید. اگر درگاهی ندارید، این تب پنهان است.
قدمبهقدم
۱. مشاهده مانده و تازهسازی
با باز شدن مودال، ابتدا تب گردش کیف پول فعال است. ماندهٔ فعلی را در کارت بالا ببینید. در صورت تردید یا پس از پرداخت خارج از مودال، دکمهٔ Refresh در گوشهٔ هدر (کنار بستن) را بزنید تا مانده و جدول دوباره بارگذاری شوند.
۲. شارژ کیف پرتال
روی دکمهٔ شارژ در کارت مانده کلیک کنید تا مودال شارژ باز شود. مبلغ و روش پرداخت را طبق راهنمای همان فرم تکمیل کنید. پس از اتمام موفق، مودال شارژ بسته میشود و در صورت نیاز ماندهٔ کیف بهصورت خودکار بهروز میشود (ممکن است چند لحظه تأخیر داشته باشد؛ در صورت نیاز Refresh بزنید).
۳. فیلتر و مرور تراکنشها
در بخش فیلترها، بر اساس دسته، نوع، تاریخ از/تا و گزینهٔ تراکنش سیستمی محدود کنید و اعمال کنید. جدول زیرین ردیفها را با صفحهبندی نشان میدهد؛ با تغییر صفحه، همان فیلترهای فعال حفظ میشوند. برای شروع دوباره میتوانید از رفتار «ریست» در فیلترها (در صورت وجود در UI) یا بستن و باز کردن مودال استفاده کنید.
۴. مدیریت درگاههای پرداخت
به تب درگاههای پرداخت بروید. درگاه جدید اضافه کنید یا درگاههای موجود را ویرایش/غیرفعال کنید طبق فرمها. پس از ذخیره، تعداد درگاه در عنوان تب بهروز میشود. تعریف حداقل یک درگاه، شرط نمایش تب «تراکنشهای درگاه» است.
۵. تراکنشهای درگاه
اگر حداقل یک درگاه دارید، تب تراکنشهای درگاه ظاهر میشود؛ پرداختهای ثبتشده از مسیر درگاه را اینجا مرور کنید. اگر درگاه حذف یا غیرفعال شود و تب مخفی گردد، بهصورت خودکار به تب گردش کیف برگردانده میشوید.
نکات
- قبل از فعالسازی درگاه، فقط <span class="font-mono">81.12.30.43</span> و <span class="font-mono">134.255.200.130</span> را به بانک اعلام کنید.
- پس از هر پرداخت مهم، یک بار Refresh بزنید تا مانده با سرور یکی باشد.
- درگاهها را فقط با اطلاعات رسمی بانک/PSP تنظیم کنید و کلیدها را در اختیار افراد غیرمجاز نگذارید.
- برای گزارش مالی، از فیلتر تاریخ و خروجیهای احتمالی جدول (در صورت وجود در نسخهٔ شما) استفاده کنید.