افزونه پرداخت ارز دیجیتال ووکامرس: پذیرش USDC و تتر
برای پذیرش ارز دیجیتال در ووکامرس، افزونه پرداختی نصب می‌کنید که خریدار را به صفحه پرداخت ارز دیجیتال می‌فرستد و پس از تأیید پرداخت، سفارش را پرداخت‌شده علامت می‌زند. بیشتر فروشگاه‌ها استیبل‌کوین‌هایی مثل USDC و تتر (USDT) را ترجیح می‌دهند تا قیمت بین ثبت سفارش و پرداخت تغییر نکند.
این راهنما افزونه‌های پرداخت ارز دیجیتال ووکامرس رایج را مقایسه می‌کند و سپس افزونه OrcaRail را گام‌به‌گام، از حالت آزمایشی و بدون پول واقعی، راه‌اندازی می‌کند.
افشا: OrcaRail ناشر این بلاگ و سازنده یکی از افزونه‌های زیر است. اطلاعات افزونه‌های دیگر از صفحه‌های آن‌ها در WordPress.org، در ۱ نوامبر ۲۰۲۶ بررسی شده است. افزونه‌ها تغییر می‌کنند؛ پیش از نصب صفحه را ببینید.
در افزونه ارز دیجیتال ووکامرس دنبال چه باشیم
- استیبل‌کوین‌ها و شبکه‌ها. مطمئن شوید افزونه توکن‌هایی را که مشتریانتان دارند، روی شبکه‌های ارزان مثل Base، Polygon یا سولانا، می‌پذیرد.
- وب‌هوک تأییدشده. سفارش فقط باید پس از یک اعلان امضاشده سرور به سرور پرداخت‌شده شود، نه فقط با بازگشت مرورگر.
- Checkout Blocks و HPOS. فروشگاه‌های جدید ووکامرس از صفحه پرداخت بلوکی و ذخیره‌سازی سفارش با کارایی بالا (HPOS) استفاده می‌کنند. برخی افزونه‌های قدیمی از آن‌ها پشتیبانی نمی‌کنند.
- حالت آزمایشی. باید بتوانید پیش از راه‌اندازی واقعی، روی تست‌نت سفارش آزمایشی ثبت کنید.
- کارمزد و نگهداری وجوه. کارمزد هر پرداخت را بدانید و اینکه وجوه به کیف‌پول خودتان می‌رسد یا به حساب ارائه‌دهنده.
مقایسه افزونه‌های رایج ارز دیجیتال ووکامرس
| افزونه | کارمزد ارائه‌دهنده (طبق صفحه) | نگهداری وجوه | Checkout Blocks | نصب فعال |
|---|---|---|---|---|
| OrcaRail for WooCommerce | ۰٫۵٪ میزبانی‌شده، ۱۰۰ تراکنش اول رایگان | به‌طور پیش‌فرض غیرامانی: آدرس‌های برداشت شما | بله | جدید (نسخه GitHub) |
| BTCPay for WooCommerce | «Zero fees» (BTCPay Server را خودتان اجرا می‌کنید) | «Self-custodial» | اصلاحات در تغییرات نسخه | بیش از ۱٬۰۰۰ |
| CoinGate for WooCommerce | «Starting at 1%» | وجوه به حساب CoinGate شما می‌رسد | بله (v2.3.0) | بیش از ۴۰۰ |
| NOWPayments for WooCommerce | ذکر نشده | ذکر نشده | بله | بیش از ۳٬۰۰۰ |
نکته‌هایی از صفحه‌ها:
- BTCPay بیت‌کوین‌محور است و به یک BTCPay Server نیاز دارد که خودتان میزبانی یا اجاره می‌کنید.
- صفحه CoinGate هشدار می‌دهد که افزونه با ۳ نسخه اصلی اخیر وردپرس آزموده نشده است.
- NOWPayments for WooCommerce را CoderPress توسعه می‌دهد و اشتراک ارز دیجیتال را فقط در نسخه Pro ارائه می‌کند.
افزونه OrcaRail چطور کار می‌کند
افزونه ووکامرس OrcaRail متن‌باز (MIT) است و از صفحه پرداخت میزبانی‌شده OrcaRail استفاده می‌کند.
- هنگام ثبت سفارش، افزونه با SDK پی‌اچ‌پی یک payment intent می‌سازد و تأیید می‌کند.
- خریدار به صفحه پرداخت OrcaRail می‌رود و با ارز دیجیتال پرداخت می‌کند.
- وقتی خریدار برمی‌گردد، افزونه پرداخت را با API بررسی می‌کند. هیچ‌وقت فقط به بازگشت مرورگر اعتماد نمی‌کند.
- افزونه روی intent پرداخت‌شده
completeرا صدا می‌زند. یک کار ساعتی WP-Cron همین کار را برای سفارش‌های اخیری که خریدارشان برنگشته انجام می‌دهد. - یک وب‌هوک امضاشده سفارش ووکامرس را به‌روز می‌کند. به‌روزرسانی‌ها idempotent هستند، پس تلاش دوباره سفارش را دو بار پردازش نمی‌کند.
پشتیبانی می‌شود: محصولات با پرداخت یک‌باره، صفحه پرداخت کلاسیک و Checkout Blocks، HPOS، وب‌هوک تأییدشده و حالت آزمایشی. هنوز پشتیبانی نمی‌شود: بازپرداخت از داخل ووکامرس، WooCommerce Subscriptions و روش‌های پرداخت ذخیره‌شده، و کیف‌پول‌های سریع. یک توکن و یک شبکه برای دریافت انتخاب می‌کنید؛ برای پرداخت دوره‌ای از API اشتراک OrcaRail استفاده کنید.
راه‌اندازی افزونه ووکامرس OrcaRail
پیش‌نیازها: PHP 8.1+، وردپرس 6.4+، ووکامرس 8.0+ و یک حساب OrcaRail.
- افزونه را دانلود کنید. آخرین فایل ZIP را از GitHub releases بگیرید. وابستگی‌ها داخل آن است و به Composer نیازی ندارید.
- نصب و فعال کنید. در وردپرس به افزونه‌ها ← افزودن ← بارگذاری افزونه بروید، فایل ZIP را بارگذاری و فعال کنید.
- کلید سندباکس بسازید. در داشبورد OrcaRail گزینه Go to sandbox را باز کنید و یک کلید API (
ak_test_…) بسازید. سندباکس‌ها روی تست‌نت و بدون پول واقعی کار می‌کنند. ساخت سندباکس را ببینید. - توکن و شبکه دریافتی را انتخاب کنید. مثلاً اکنون USDC روی تست‌نت و هنگام راه‌اندازی واقعی USDC روی Base. شناسه توکن و شبکه از
GET /payments/networksوGET /payments/networks/:id/tokensمی‌آید. شبکه‌ها و توکن‌ها را ببینید. - تنظیمات را پر کنید. به ووکامرس ← تنظیمات ← پرداخت‌ها ← OrcaRail بروید، فیلدهای Test (کلید، رمز، رمز امضای وب‌هوک، شناسه توکن، شناسه شبکه) را پر کنید و حالت آزمایشی را فعال کنید.
- آدرس وب‌هوک را تنظیم کنید. در داشبورد OrcaRail، آدرس وب‌هوک کلید API را همان آدرسی بگذارید که افزونه نشان می‌دهد:
https://your-store.example/?wc-api=wc_gateway_orcarail&orcarail=webhook. امضای وب‌هوک را ببینید. - سفارش آزمایشی ثبت کنید. در صفحه پرداخت تست‌نت می‌توانید بدون کیف‌پول پرداخت را شبیه‌سازی کنید. بررسی کنید سفارش پرداخت‌شده شود.
- راه‌اندازی واقعی. در سازمان واقعی خود یک کلید API واقعی (
ak_live_…) بسازید، فیلدهای واقعی را با توکن و شبکه اصلی پر کنید و حالت آزمایشی را خاموش کنید. راه‌اندازی واقعی را ببینید.
فروشگاه واقعی رویدادهای وب‌هوک سندباکس را نادیده می‌گیرد و فروشگاه در حالت آزمایشی رویدادهای واقعی را، پس نمی‌توانید آن‌ها را اشتباهی قاطی کنید.
هزینه
OrcaRail میزبانی‌شده ۰٫۵٪ از هر تراکنش تکمیل‌شده می‌گیرد و ۱۰۰ تراکنش اول رایگان است. سفارش ۱۰۰ دلاری ۰٫۵۰ دلار هزینه دارد. خود افزونه رایگان است. کارمزد شبکه جداست. قیمت‌گذاری و کارمزدها و محدودیت‌ها را ببینید.
پرسش‌های متداول
بهترین افزونه ارز دیجیتال ووکامرس کدام است؟
بستگی دارد چه چیزی می‌خواهید دریافت کنید. برای بیت‌کوین با خودمیزبانی، BTCPay پخته است. برای استیبل‌کوین‌هایی مثل USDC و تتر روی زنجیره‌های EVM و سولانا که مستقیم به کیف‌پول خودتان واریز شوند، OrcaRail برای همین ساخته شده است. کارمزد، نگهداری وجوه و پشتیبانی Checkout Blocks را در جدول بالا مقایسه کنید.
آیا می‌توانم در ووکامرس تتر بپذیرم؟
بله. توکن و شبکه افزونه را USDT روی یک شبکه پشتیبانی‌شده مثل Ethereum، Polygon یا Arbitrum بگذارید. Tron (TRC20) هنوز پشتیبانی نمی‌شود. چطور پرداخت تتر بپذیریم را ببینید.
سفارش ووکامرس کی پرداخت‌شده می‌شود؟
وقتی پرداخت روی زنجیره تأیید شود و افزونه آن را با API OrcaRail، از طریق وب‌هوک یا بررسی هنگام بازگشت، تأیید کرده باشد. بازگشت مرورگر به‌تنهایی هیچ‌وقت سفارش را پرداخت‌شده نمی‌کند.
آیا افزونه از WooCommerce Subscriptions پشتیبانی می‌کند؟
هنوز نه. افزونه پرداخت‌های یک‌باره را انجام می‌دهد. برای پرداخت دوره‌ای مستقیماً از اشتراک‌های OrcaRail استفاده کنید یا پرداخت‌های دوره‌ای ارز دیجیتال را بخوانید.
آیا می‌توانم بدون ارز دیجیتال واقعی آزمایش کنم؟
بله. حالت آزمایشی را با کلیدهای سندباکس فعال کنید. سفارش‌ها روی تست‌نت اجرا می‌شوند و می‌توانید پرداخت را در صفحه پرداخت شبیه‌سازی کنید.