کارت‌به‌کارت خودکار برای ووکامرس
راهنمای قدم‌به‌قدم راه‌اندازی پرداخت کارت‌به‌کارت با تایید خودکار در ووکامرس: نصب افزونه واریزت، اتصال یک‌کلیکی، تست در Sandbox و تنظیمات مهم درگاه.
کارت‌به‌کارت هنوز یکی از رایج‌ترین روش‌های پرداخت در فروشگاه‌های اینترنتی است؛ بی‌کارمزد، آنی و بدون قرارداد بانکی. مشکل همیشه یک چیز بوده: تایید دستی. در این راهنما می‌بینید چطور با افزونه واریزت، کارت‌به‌کارت در ووکامرس مثل یک درگاه پرداخت کار می‌کند و سفارش‌ها خودکار تایید می‌شوند.
جریان پرداخت چطور است؟
- مشتری در صفحه تسویه حساب «کارت‌به‌کارت (تایید خودکار)» را انتخاب می‌کند.
- افزونه با API واریزت سفارشی با مبلغ یکتا می‌سازد، مثلاً ۸٬۵۰۰٬۴۳۰ ریال به‌جای ۸٬۵۰۰٬۰۰۰ ریال.
- مشتری به صفحه پرداخت هدایت می‌شود (یا همان‌جا در صفحه تشکر، ویجت پرداخت را می‌بیند) و مبلغ دقیق را واریز می‌کند.
- واریزت واریز را از پیامک یا اعلان بانک تشخیص می‌دهد و وب‌هوک امضاشده
order.paidرا به فروشگاه شما می‌فرستد. - افزونه امضا را بررسی می‌کند و سفارش را «در حال انجام» یا «تکمیل‌شده» می‌کند.
راه‌اندازی در پنج دقیقه
۱. نصب افزونه
افزونه را از مخزن وردپرس یا از بخش «یکپارچه‌سازی‌ها» در پنل واریزت دریافت و فعال کنید. نیازمندی‌ها: PHP 8.1 یا بالاتر، وردپرس 6.4 یا بالاتر و ووکامرس 8.5 یا بالاتر. افزونه با HPOS و صفحه پرداخت بلوکی (Checkout Blocks) سازگار است.
۲. اتصال یک‌کلیکی
در «ووکامرس › تنظیمات › پرداخت‌ها › واریزت» روی «اتصال به واریزت» بزنید. وارد پنل می‌شوید، فروشگاه را انتخاب و دسترسی‌ها را تایید می‌کنید. افزونه یک کلید API با دسترسی محدود (orders:read و orders:write) و یک endpoint وب‌هوک با آدرس سایت شما دریافت و رمزنگاری‌شده ذخیره می‌کند. لازم نیست هیچ کلیدی را دستی کپی کنید.
۳. تست در حالت Sandbox
پیش از فروش واقعی، سوییچ محیط را روی Test بگذارید و یک سفارش آزمایشی ثبت کنید. سپس از پنل واریزت یا با API یک واریز شبیه‌سازی کنید:
curl -X POST https://api.varizet.ir/v1/test/deposits \
-H "Authorization: Bearer vz_test_4eC39HqLyjWDarjt" \
-H "Content-Type: application/json" \
-d '{"amount": 8500430}'چند ثانیه بعد سفارش آزمایشی در ووکامرس پرداخت‌شده می‌شود و در متاباکس سفارش، تایم‌لاین و امتیاز اطمینان تطبیق را می‌بینید.
۴. فعال کردن Live
کارت مقصد را در پنل اضافه کنید، اپ اندروید یا میان‌بر آیفون را روی گوشی‌ای که پیامک بانک را می‌گیرد نصب کنید و محیط را روی Live بگذارید. از این لحظه سفارش‌های واقعی خودکار تایید می‌شوند.
تنظیماتی که ارزش بررسی دارند
- حالت مبلغ یکتا: افزایشی (پیش‌فرض) یا کاهشی؛ در حالت کاهشی مشتری هرگز بیشتر از قیمت نمی‌پردازد.
- مهلت پرداخت: معمولاً ۳۰ دقیقه کافی است؛ پس از آن مهلت تکمیلی کوتاهی برای واریزهای دیرهنگام باقی می‌ماند.
- ۴ رقم آخر کارت: می‌توانید از مشتری بخواهید ۴ رقم آخر کارتش را وارد کند تا امتیاز اطمینان بالاتر برود.
- وضعیت پس از پرداخت: «در حال انجام» برای کالای فیزیکی و «تکمیل‌شده» برای محصولات دیجیتال.
- بازگرداندن موجودی: اگر سفارشی منقضی شود، موجودی رزروشده خودکار برمی‌گردد.
چرا سفارشی جا نمی‌ماند؟
تایید اصلی با وب‌هوک لحظه‌ای انجام می‌شود که تا ۸ بار در ۲۴ ساعت دوباره ارسال می‌شود. علاوه بر آن، افزونه هر ۲ دقیقه سفارش‌های در انتظار را با یک درخواست دسته‌ای از API بررسی می‌کند. اگر سایت شما لحظه‌ای در دسترس نباشد یا وب‌هوک به هر دلیلی نرسد، همگام‌سازی پشتیبان وضعیت را درست می‌کند.