نصب و راهاندازی کامل هرمزپی
از نصب افزونه وردپرس تا اتصال اپ اختصاصی اندروید، دریافت پیامک بانکی و تأیید خودکار پرداختها؛ مرحلهبهمرحله و کاملاً فارسی.
پیشنیازهای نصب
موارد لازم را قبل از شروع آماده کنید.
- یک سایت وردپرسی با دسترسی مدیر و امکان نصب افزونه
- فایل ZIP افزونه هرمزپی و فایل APK اپ اندروید
- یک گوشی اندرویدی که پیامک یا اعلان بانکی روی آن دریافت میشود
- برای فروشگاه: ووکامرس یا Easy Digital Downloads
- برای مولتیوندور: ووکامرس و Dokan
مسیر کلی راهاندازی
نصب افزونه
فایل ZIP را در وردپرس بارگذاری و فعال کنید.
ثبت مقصد پرداخت
کارت، پل، شبا یا حساب بانکی مقصد را وارد کنید.
دریافت لینک وبهوک
وبهوک اپ اندروید را فعال و آدرس کامل را کپی کنید.
نصب و اتصال اپ
APK را نصب، مجوزها را فعال و لینک را در اپ ثبت کنید.
تست نهایی
یک پیام آزمایشی یا پرداخت واقعی کنترلشده ارسال کنید.
نصب افزونه هرمزپی روی وردپرس
نصب استاندارد از پیشخوان وردپرس.
ورود به مدیریت وردپرس
با حساب مدیر وارد پیشخوان شوید.
باز کردن نصب افزونه
افزونهها ← افزودن افزونه تازه ← بارگذاری افزونه.
انتخاب فایل ZIP
فایل هرمزپی را بدون خارجکردن از حالت فشرده انتخاب کنید.
نصب و فعالسازی
«هماکنون نصب نمایید» و سپس «فعالکردن افزونه» را بزنید.
ورود به هرمزپی
از منوی مدیریت وارد هرمزپی شوید.
تنظیمات پایه و صفحه پرداخت
عنوان درگاه، واحد پول، مهلت و ظاهر صفحه را تنظیم کنید.
- حالت صفحه پرداخت: داخل قالب سایت یا صفحه مجزا
- نمایش مقصد: کارت بانکی واقعی یا حالت ساده
- نمایش مبلغ اصلی، مبلغ یکتا، هشدار، رسید و نتیجه
- فعال یا غیرفعالکردن کادر، سایه، رنگ مبنا و CSS سفارشی
- نمایش اعلان «کپی شد» برای کارت، شبا و حساب
افزودن مقصد بانکی
فقط روشهایی را فعال کنید که باید به مشتری نمایش داده شوند.
انتخاب روش واریز
کارتبهکارت، پل، شبا یا شماره حساب را فعال کنید.
اطلاعات بانکی
نام بانک، صاحب حساب و شمارهها را دقیق وارد کنید.
ترتیب و وضعیت
ترتیب نمایش و مقصد پیشفرض را مشخص کنید.
ذخیره و بازبینی
صفحه پرداخت را روی موبایل باز و دکمههای کپی را آزمایش کنید.
دریافت وبهوک اپ اندروید
پل ارتباطی امن میان اپ اختصاصی و افزونه وردپرس.
- در تنظیمات هرمزپی، بخش «وبهوک اپ» را باز کنید
- گزینه اجازه فعالسازی اپ هرمزپی را روشن کنید
- آدرس کامل شامل Token را بدون تغییر کپی کنید
- اگر توکن فاش شد، توکن جدید بسازید و آدرسهای اپ را بهروزرسانی کنید
نصب اپ اختصاصی هرمزپی روی اندروید
اپ اختصاصی، پیامک و اعلان بانکی را دریافت و امن به سایت ارسال میکند.
انتقال APK به گوشی
فایل را از منبع معتبر دریافت و روی گوشی باز کنید.
اجازه نصب
اجازه نصب برنامههای ناشناس را فقط برای برنامه بازکننده فایل فعال کنید.
نصب برنامه
روی Install / نصب بزنید و هرمزپی را اجرا کنید.
ثبت اولین وبهوک
لینک کپیشده را وارد و «بررسی، افزودن و فعالسازی» را لمس کنید.
کنترل نتیجه تست
نام وبهوک و پاسخ HTTP باید روی همان کارت دیده شود.
فعالکردن مجوزها و اجرای دائمی
برای دریافت پایدار اعلان بانکی، سرویس نباید در پسزمینه متوقف شود.
- دسترسی خواندن اعلانها برای پیامک و برنامههای بانکی
- فعالکردن باتری، Autostart و اجرای دائمی
- خارجکردن هرمزپی از Sleeping / Optimized در سامسونگ، شیائومی و هواوی
- در اندروید ۱۳ به بعد، اجازه نمایش اعلان هرمزپی
ثبت، تأیید و امنیت گوشی
هر دستگاه باید مالک، نقش و وضعیت مشخص داشته باشد.
- اولین گوشی میتواند گوشی مدیر اصلی باشد
- گوشی دوم تا زمان تأیید مدیر در وضعیت «در انتظار» میماند
- برای گوشی فروشنده، گزینه «این گوشی ادمین نیست» را فعال کنید
- گوشی تأییدنشده یا مسدود نمیتواند پرداخت را تأیید کند
- نام مدیر تأییدکننده و زمان تأیید در لاگ ثبت میشود
تست اتصال و اولین پیام
قبل از استفاده واقعی، کل مسیر را کنترل کنید.
تست وبهوک
پاسخ HTTP 200 نشانه دسترسی صحیح است.
پیام آزمایشی
از ارسال دستی، یک متن مشابه پیام بانک بفرستید.
بررسی پنل
گوشی، متن، نتیجه و مبلغ استخراجشده را ببینید.
کنترل دلیل استخراج
قالب داخلی بانک یا تحلیل هوشمند را بررسی کنید.
تست پرداخت
یک سفارش کممبلغ بسازید و مبلغ یکتا را بررسی کنید.
راهاندازی مولتیوندور ووکامرس و دکان
مقصد و گوشی اختصاصی برای هر فروشنده.
- برای هر فروشنده یک مقصد بانکی اختصاصی بسازید
- گوشی فروشنده را به همان فروشنده متصل کنید
- قفل امنیتی گوشی و مقصد را روشن نگه دارید
- پرداخت فقط با گوشی ادمین اصلی یا گوشی همان فروشنده تأیید میشود
- گوشی یک فروشنده اجازه تأیید سفارش فروشنده دیگر را ندارد
اتصال فرمها، عضویت و افزونههای دیگر
آداپتورهای هرمزپی برای سناریوهای مختلف پرداخت.
انتخاب فرم، مبلغ، موبایل و نام؛ Entry تا تأیید Pending میماند.
اتصال اختصاصی مبتنی بر Entry و قوانین فیلدها.
فعالشدن سطح عضویت پس از تأیید پرداخت.
تکمیل تراکنش Pending/Offline پس از تأیید.
ساخت پرداخت، تکمیل سفارش و اعلان موفق.
اتصال افزونههای اختصاصی با شناسه مبدأ، سفارش، مبلغ و URL بازگشت.
رفع خطاهای رایج
نشانه، علت احتمالی و راهحل سریع.
| نشانه | راهحل |
|---|---|
| وبهوک 404 | ساختار لینک، HTTPS، REST API و ذخیره پیوندهای یکتا را بررسی کنید. |
| HTTP 401 / 403 | توکن، فایروال، افزونه امنیتی و وضعیت مسدودبودن گوشی را بررسی کنید. |
| پیامک دریافت نمیشود | مجوز اعلان، Listener، باتری و برنامههای مجاز همان وبهوک را کنترل کنید. |
| مبلغ پیدا نشد | پیام را در پیامکهای ناشناخته باز کنید و مبلغ، مانده و حساب را آموزش دهید. |
| پرداخت فروشنده تأیید نشد | اتصال گوشی، مقصد فروشنده و مالکیت محصول سفارش را بررسی کنید. |
| وبهوک تکراری | همان کارت وبهوک را ویرایش یا بهروزرسانی کنید؛ دوباره ثبت نکنید. |
| اپ در پسزمینه متوقف میشود | Battery Optimization را غیرفعال، Autostart و اجرای دائمی را فعال کنید. |
چکلیست تحویل
- افزونه فعال و تنظیمات ذخیره شده است
- حداقل یک مقصد بانکی معتبر و فعال وجود دارد
- وبهوک با پاسخ HTTP 200 تست شده است
- دسترسی اعلان و اجرای دائمی اپ فعال است
- گوشی در پنل شناسایی و تأیید شده است
- پیام آزمایشی در فهرست پیامکهای بانکی ثبت شده است
- یک پرداخت کنترلشده با مبلغ یکتا تأیید شده است