احرازینو

افزونهٔ وردپرس و ووکامرس

استعلام‌های چک‌اوت ووکامرس، بدون کدنویسی

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

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

نسخهٔ ۱.۱۱.۰ · ۱۱۰ کیلوبایت · مجوز GPLv2

افزونه چه می‌کند

دو قابلیت، هر کدام برای یک ضرر مشخص که فروشگاه‌های ایرانی می‌دهند.

احراز هویت، پیش یا پس از پرداخت

زمانش را در تنظیمات افزونه انتخاب می‌کنید و هر وقت خواستید عوضش می‌کنید.

نصب در سه گام

  1. نصب افزونه

    فایل را بگیرید و در وردپرس از «افزونه‌ها ← افزودن ← بارگذاری افزونه» نصب و فعال کنید.

  2. ساخت کلید API

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

  3. روشن‌کردن قابلیت‌ها

    در «ووکامرس ← تنظیمات ← احرازینو» کلید را بگذارید و هر قابلیتی را که می‌خواهید، جداگانه روشن کنید.

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

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

خودِ افزونه رایگان است و برای همیشه رایگان می‌ماند. آنچه هزینه دارد، هر استعلام است: از موجودی پنل کسب‌وکارتان کم می‌شود و قیمتش پیش از فراخوان قطعی است. مصرف را روزبه‌روز در گزارش پنل می‌بینید.

تعرفهٔ استعلام‌هادربارهٔ API کسب‌وکار

پرسش‌های پرتکرار

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

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

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

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

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

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

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

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

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

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

دکمهٔ «دریافت خودکار نشانی» هیچ کاری نمی‌کند، چه کنم؟

اول در **ووکامرس › تنظیمات › احرازینو** دکمهٔ «آزمون اتصال» را بزنید. نتیجه‌اش صریح می‌گوید مشکل کجاست و این آزمون هزینه‌ای ندارد.

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

1. `/?wc-ajax=ehrazino_lookup_postcode` 2. `/?rest_route=/ehrazino/v1/postcode` 3. `/wp-admin/admin-ajax.php`

اگر به‌جای ۴۰۴، خطای **۵۰۲ یا ۵۰۴** می‌گیرید، معنایش فرق می‌کند: وردپرس بالا آمده و درخواست وسط کار قطع شده. تنها کار کندِ این مسیر، تماس سرور شما با احرازینو است، پس تقریباً همیشه یعنی سرور فروشگاه به ما نمی‌رسد. «آزمون اتصال» در تنظیمات، همین را صریح می‌گوید.

بعضی میزبان‌ها برای «سخت‌کردن وردپرس» کل `/wp-admin/` را می‌بندند و آن مسیر از مرورگر ۴۰۴ می‌دهد. وقتی با حساب مدیر وارد باشید، افزونه همین را زیر همان پیام به شما می‌گوید؛ مشتری آن را نمی‌بیند. متن را برای میزبان وب خود بفرستید.

احراز پس از پرداخت دقیقاً چه می‌کند؟

وقتی درگاه پرداخت (یا پرداخت در محل) می‌خواهد سفارش را «در حال انجام» کند، افزونه به‌جایش وضعیت **«در انتظار احراز هویت»** می‌گذارد:

1. موجودی انبار مثل همیشه کم می‌شود و سفارش «پرداخت‌شده» حساب می‌شود. 2. ایمیل «سفارش تازه» برای شما می‌رود، و برای مشتری ایمیل «یک قدم تا ارسال سفارش» با لینک وارد کردن کد ملی. این ایمیل در «ووکامرس ← تنظیمات ← ایمیل‌ها» قابل ویرایش یا خاموش‌کردن است. 3. تطابق کد ملی با موبایل سفارش، سفارش را آزاد می‌کند و ایمیل «در حال انجام» برای مشتری می‌رود. 4. مشتری تا سه بار فرصت دارد. کد ملیِ بدشکل نه تلاش حساب می‌شود و نه هزینه دارد.

لینک ایمیل به یک صفحهٔ سادهٔ مستقل می‌رود که فقط با همان لینک باز می‌شود؛ مشتری لازم نیست وارد حسابش شود یا ایمیلش را دوباره بنویسد. این صفحه در موتورهای جست‌وجو نمایه نمی‌شود و در کش صفحه هم نمی‌ماند.

اگر شمارهٔ تلفن سفارش موبایل نباشد (مثلاً تلفن ثابت)، تطبیق ممکن نیست؛ سفارش نگه داشته می‌ماند و به شما ایمیل می‌شود. شماره‌هایی که با +۹۸ یا ۰۰۹۸ ذخیره شده‌اند، درست خوانده می‌شوند.

در این حالت فیلد تلفن صفحهٔ تسویه اجباری است و فقط شمارهٔ موبایل پذیرفته می‌شود، چون احراز با همان شماره انجام می‌شود.

فقط سفارش‌هایی نگه داشته می‌شوند که درگاه پرداخت آنلاین یا پرداخت در محل آن‌ها را «در حال انجام» می‌کند. سفارشی که شما دستی تأیید می‌کنید (مثل کارت‌به‌کارت یا واریز بانکی) نگه داشته نمی‌شود، چون تأییدش با خود شماست. تمدید خودکار اشتراک هم نگه داشته نمی‌شود.

فایل‌های دانلودی تا تأیید تحویل نمی‌شوند. از صفحهٔ سفارش می‌توانید درخواست احراز را دوباره برای مشتری بفرستید، یا با تغییر دستی وضعیت به «در حال انجام»، سفارش را بدون احراز آزاد کنید. اگر افزونه غیرفعال شود، سفارش‌های منتظر به «در انتظار بررسی» می‌روند تا از فهرست‌ها گم نشوند.

با افزونهٔ ورود پیامکی (دیجیتس، ورودک و مانند آن‌ها) کار می‌کند؟

بله. در تنظیمات «احراز هنگام ساخت حساب» را روشن کنید و «ثبت‌نام سایت شما با» را روی «افزونهٔ ورود پیامکی» بگذارید. آن افزونه موبایل را با کد پیامکی تأیید می‌کند و احرازینو همان لحظه پس از ساخت حساب، کد ملی را می‌پرسد و با همان موبایل تطبیق می‌دهد.

احرازینو به هیچ افزونهٔ پیامکیِ خاصی وابسته نیست و فقط از قلاب‌های خود وردپرس استفاده می‌کند، پس با به‌روزرسانی آن افزونه نمی‌شکند. موبایل از نام کاربری یا تلفن صورتحساب خوانده می‌شود؛ اگر افزونهٔ شما موبایل را جای دیگری نگه می‌دارد، نام آن کلید را در «کلید متای موبایل» بنویسید.

افزونه را چطور به‌روز کنم؟

از نسخهٔ ۱٫۸٫۰ به بعد، مثل هر افزونهٔ دیگری: نسخهٔ تازه در «پیشخوان ← به‌روزرسانی‌ها» می‌آید و با یک کلیک نصب می‌شود؛ می‌توانید به‌روزرسانی خودکار را هم در صفحهٔ افزونه‌ها روشن کنید. نسخه‌های پیش از ۱٫۸٫۰ این امکان را ندارند و یک بار باید فایل تازه را از سایت احرازینو دستی بارگذاری کنید.

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

بله، هر دو. افزونه سازگاری‌اش را رسماً اعلام می‌کند و هیچ‌جا `get_post_meta` روی سفارش صدا نمی‌زند. از نسخهٔ ۱٫۱۱٫۰ فیلد کد ملیِ «پیش از پرداخت» در چک‌اوت بلوکی هم هست (ووکامرس ۸٫۹ به بعد) و در بخش «اطلاعات سفارش» می‌آید؛ برچسب و الزامی‌بودنش از همان تنظیم‌هاست. تکمیل خودکار نشانی هنوز فقط روی چک‌اوت کلاسیک کار می‌کند. احراز «پس از پرداخت» در هر دو کامل کار می‌کند.

مشتری می‌تواند کد ملی‌اش را در حساب کاربری ثبت یا ویرایش کند؟

بله، از نسخهٔ ۱٫۱۱٫۰. در تنظیمات «کد ملی در جزئیات حساب مشتری» را روشن کنید تا فیلد کد ملی در «حساب کاربری من ← جزئیات حساب» بیاید. کد ملی فقط وقتی ذخیره می‌شود که با شمارهٔ موبایل حساب بخواند؛ پس از آن، خریدهای بعدی با همان شماره بدون پرسیدن دوبارهٔ کد ملی انجام می‌شود. هر ثبت یا تغییر یک استعلام است و پس از سه بار عدم تطابق، فیلد برای آن حساب بسته می‌شود.

افزونه را بگیرید و در چند دقیقه راه بیندازید

نصب روی وردپرس، بدون کدنویسی. برای گرفتن کلید API هم یک حساب کسب‌وکار در احرازینو کافی است.

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

نسخهٔ ۱.۱۱.۰ · ۱۱۰ کیلوبایت · مجوز GPLv2