=== احرازینو برای ووکامرس ===
Contributors: ehrazino
Tags: woocommerce, iran, checkout, address, verification
Requires at least: 6.4
Tested up to: 6.7
Requires PHP: 7.4
Stable tag: 1.3.1
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

سه استعلام کاربردی برای فروشگاه‌های ایرانی: تکمیل خودکار نشانی از کد
پستی، تطابق شمارهٔ موبایل با کد ملی، و تأیید نام صاحب کارت.

== Description ==

= ۱. تکمیل خودکار نشانی =

مشتری کد پستی را می‌زند و نشانی‌اش پر می‌شود. نشانی غلط یعنی مرسولهٔ
برگشتی، و هزینهٔ هر مرسولهٔ برگشتی از هزینهٔ صدها استعلام بیشتر است.

نتیجه‌ها یک هفته کش می‌شوند، پس کد پستی تکراری دوباره هزینه نمی‌برد.

= ۲. تطابق موبایل با کد ملی (شاهکار) =

پس از ثبت سفارش بررسی می‌شود که شمارهٔ موبایل واقعاً به همان کد ملی
تعلق دارد. برای فروشگاه‌هایی که پرداخت‌در‌محل دارند و از سفارش جعلی
ضرر می‌کنند.

= ۳. تأیید نام صاحب کارت =

ابزار صفحهٔ سفارش برای پرداخت کارت‌به‌کارت: شمارهٔ کارت واریزکننده را
وارد می‌کنید و نام صاحبش با نام سفارش مقایسه می‌شود.

**شمارهٔ کارت ذخیره نمی‌شود.** فقط چهار رقم آخر و نتیجهٔ مقایسه.

= اگر سرویس قطع باشد چه می‌شود؟ =

سفارش **ثبت می‌شود** و برچسب «نامعلوم، بررسی دستی» می‌گیرد.

یک قطعی نیم‌ساعته نباید یعنی نیم‌ساعت فروش صفر. ولی سفارش تأییدنشده هم
نباید بی‌صدا رد شود، پس در ستون «احراز» فهرست سفارش‌ها دیده می‌شود.

== Installation ==

1. افزونه را نصب و فعال کنید.
2. در [پنل کسب‌وکار احرازینو](https://ehrazino.com/dashboard/api/keys/) یک کلید API بسازید.
3. ووکامرس ← تنظیمات ← احرازینو: کلید را وارد و قابلیت‌های دلخواه را روشن کنید.

همهٔ قابلیت‌ها پیش‌فرض **خاموش**اند. افزونه تا وقتی خودتان نگویید،
هیچ فراخوانی نمی‌زند و هیچ هزینه‌ای نمی‌سازد.

= پیش از روشن‌کردن، در آزمایشگاه امتحان کنید =

پنل احرازینو یک [آزمایشگاه](https://ehrazino.com/dashboard/api/lab/)
دارد که ورودی را رایگان می‌سنجد و قطعه‌کد آماده می‌دهد.

== Frequently Asked Questions ==

= کلید API من کجا ذخیره می‌شود؟ =

در `wp_options` سرور خودتان. هیچ‌وقت به مرورگر بازدیدکننده نمی‌رود و در
هیچ فایل جاوااسکریپتی نیست. با حذف افزونه، کلید هم پاک می‌شود.

= هزینه چطور حساب می‌شود؟ =

هر استعلام از موجودی پنل شما کم می‌شود و قیمتش پیش از فراخوان قطعی
است. مصرف را در [گزارش مصرف](https://ehrazino.com/dashboard/api/reports/)
روز‌به‌روز می‌بینید.

= آیا یک ربات می‌تواند موجودی من را خرج کند؟ =

مسیر تکمیل نشانی از صفحهٔ پرداخت صدا زده می‌شود و برای مهمان‌ها هم باز
است، پس سه لایه جلویش گذاشته‌ایم:

1. **سقف هر بازدیدکننده در ساعت** (پیش‌فرض ۲۰).
2. **سقف کل فروشگاه در ساعت** (پیش‌فرض ۲۰۰)، که کران بالای هزینهٔ شما
   را می‌بندد، هرچقدر هم ترافیک زیاد شود.
3. **کش هفتگی**: کد پستی تکراری دوباره هزینه نمی‌برد.

با پر شدن سقف کل، در پیشخوان اعلان می‌بینید و در گزارش ثبت می‌شود. هر
دو عدد از تنظیمات قابل تغییرند؛ متناسب با ترافیک واقعی فروشگاه بالا
ببرید، ولی آگاهانه.

= کد ملی مشتری‌ها کجا می‌رود؟ =

در متای سفارش می‌ماند (برای فاکتور رسمی)، ولی سه جا **نمی‌آید**: در
یادداشت سفارش ماسک می‌شود، در لاگ نوشته نمی‌شود، و از پاسخ REST API
ووکامرس حذف می‌شود، چون پیشوند زیرخط فقط از رابط کاربری پنهان می‌کند
و نه از REST.

= با HPOS و چک‌اوت بلوکی کار می‌کند؟ =

بله، هر دو. افزونه سازگاری‌اش را رسماً اعلام می‌کند و هیچ‌جا
`get_post_meta` روی سفارش صدا نمی‌زند.

== Changelog ==

= 1.3.1 =
* اصلاح دکمهٔ «رفتن به پنل احرازینو» که در نسخهٔ ۱.۳.۰ به نشانی اشتباه می‌رفت و صفحهٔ «پیدا نشد» می‌داد. حالا مستقیم به صفحهٔ کلیدهای پنل شما می‌رود.
* همان لینک، حالا یک دکمهٔ کامل است و در تب تازه باز می‌شود تا تغییرات ذخیره‌نشدهٔ فرم از دست نرود.

= 1.3.0 =
* بازطراحی صفحهٔ تنظیمات: قابلیت‌ها در سه کارتِ جدا، کلیدهای خاموش/روشن به‌جای تیک، و نواری که تا تغییری ذخیره نشده باشد به شما می‌گوید.
* نشانگر وضعیت در بالای صفحه: می‌گوید کلید ثبت شده، ثبت نشده، یا سرویس موقتاً پاسخ نمی‌دهد.
* دکمهٔ «بازنشانی» ویرایش‌های ذخیره‌نشده را برمی‌گرداند.
* کلید ذخیره‌شده مثل قبل هیچ‌وقت در صفحه نمی‌آید؛ فقط چند نویسهٔ اولش دیده می‌شود و برای تعویض، کلید تازه را وارد می‌کنید.

= 1.2.0 =
* قطعیِ سرویس دیگر فروشگاه را کند نمی‌کند. اگر استعلام پیاپی پاسخ ندهد، افزونه خودکار به حالت پیش‌فرض می‌رود: تکمیل نشانی دستی می‌شود و سفارش‌ها بدون معطلی ثبت می‌شوند و برچسب «بررسی دستی» می‌گیرند. چند دقیقه بعد خودش دوباره تلاش می‌کند.
* اعلان پیشخوان هنگام حالت پیش‌فرض، تا مدیر بداند سفارش‌های این بازه بدون استعلام ثبت شده‌اند.
* مهلت استعلام شاهکار در مسیر ثبت سفارش کوتاه‌تر شد تا مشتری پای دکمهٔ پرداخت منتظر نماند.

= 1.1.0 =
* به‌روزرسانی امنیتی. نصب این نسخه توصیه می‌شود.
* اصلاح «تأیید نام صاحب کارت»: در نسخه‌های پیشین ممکن بود نتیجهٔ درست را «عدم تطابق» ثبت کند. مقایسهٔ نام حالا «ي/ی»، «ك/ک» و نیم‌فاصله را یکسان می‌بیند.
* نتیجهٔ نامشخص دیگر «مردود» ثبت نمی‌شود و برچسب «نامعلوم، بررسی دستی» می‌گیرد.
* شمارش سقف نرخ روی فروشگاه‌های پشت CDN یا پراکسی اصلاح شد.
* ستون «احراز» در فهرست سفارش‌ها روی فروشگاه‌های بدون HPOS نمایش داده می‌شود.
* بازگشت پس از «بررسی نام صاحب کارت» روی فروشگاه‌های بدون HPOS اصلاح شد.
* حذف افزونه، تنظیمات و کشِ نشانی مشتری‌ها را هم پاک می‌کند.
* هشدار پیشخوان برای فروشگاه‌هایی که از چک‌اوت بلوکی استفاده می‌کنند.
* متن خطای سرویس پیش از ثبت در یادداشت سفارش پاک‌سازی می‌شود.

= 1.0.1 =
* به‌روزرسانی امنیتی. نصب این نسخه توصیه می‌شود.
* کد ملی از خروجی REST API ووکامرس حذف شد.
* کلید API در صفحهٔ تنظیمات نمایش داده نمی‌شود.
* اعلان پیشخوان هنگام پر شدن سقف مصرف.

= 1.0.0 =
* نسخهٔ اول: تکمیل نشانی از کد پستی، تطابق موبایل با کد ملی، تأیید نام صاحب کارت.
