یکپارچه‌سازی پرداخت رمزارز در WooCommerce و Shopify

اگر فروشگاه WooCommerce یا Shopify دارید، افزودن crypto به معنی بازسازی فروشگاه نیست. روش پرداخت جدید کنار بقیه می‌نشیند و فقط دو راه اتصال دارید: نصب افزونه و کلید API، یا REST API از کد خودتان. انتخاب کمتر به مهارت فنی بستگی دارد تا به اینکه چقدر checkout را خودتان کنترل کنید.

اول بگویید چرا

رمزارز به‌ندرت جایگزین کارت می‌شود. وقتی یکی از این‌ها برقرار است ارزش افزودن دارد:

• به مشتری در جایی می‌فروشید که کارت ناپایدار یا گران است.
• کالای دیجیتال می‌فروشید و chargeback تقلبی هزینه واقعی است؛ on-chain برگشت‌پذیر نیست.
• مشتریان stablecoin دارند و می‌خواهند با آن بپردازند.
• روش پرداخت می‌خواهید وابسته به یک رابطه acquiring نباشد.

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

مسیر ۱: افزونه

روی پلتفرم آماده، سریع‌ترین مسیر افزونه VisualPay است. نصب، کلید API merchant، انتخاب کوین و شبکه؛ crypto در checkout ظاهر می‌شود. بدون کد.

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

ترتیب راه‌اندازی:

1. حساب VisualPay و 2FA؛ قبل از merchant لازم است.
2. merchant بسازید و آدرس کیف خودتان را برای هر کوین و شبکه بگذارید؛ مقصد تسویه.
3. کلید API merchant را از پنل کپی کنید.
4. افزونه را نصب و کلید را وارد کنید.
5. کوین و شبکه و اینکه کارمزد را کدام طرف بپردازد مشخص کنید.
6. یک سفارش واقعی کوچک را end-to-end قبل از اعلام تست کنید.

مسیر ۲: API مستقیم

فروشگاه headless، checkout خیلی سفارشی، یا فروشگاهی که بخشی خارج از پلتفرم است؛ API کنترل کامل می‌دهد: یک POST برای ساخت تراکنش، یک webhook برای paid.

POST https://visualpay.net/api/v1/merchant/transaction/create
x-api-key: YOUR_MERCHANT_API_KEY
Content-Type: application/json

{
  "currency_symbol": "USDT",
  "network_code": "trc20",
  "amount_usd": 149.00,
  "ttl": 30,
  "order_id": 10432,
  "email": "buyer@example.com",
  "callback_url": "https://yourstore.com/checkout/crypto/return"
}

پاسخ آدرس، مبلغ crypto و tracking code است. redirect اجباری نیست؛ داخل checkout خودتان رندر کنید. tracking code را روی سفارش ذخیره کنید.

مناسب وقتی مرحله crypto باید شبیه بقیه checkout باشد، جریان روی abstraction درگاه پرداخت پلتفرم نگاشت نمی‌شود، یا نگهداری webhook endpoint برایتان راحت است.

نگاشت وضعیت پرداخت به وضعیت سفارش

اینجا یکپارچه‌سازی اغلب خراب می‌شود:

• Pending: invoice باز و unpaid. سفارش hold. موجودی کمیاب را بی‌نهایت رزرو نکنید؛ TTL می‌گوید کی آزاد شود.
• Confirmed: paid روی زنجیره. processing یا complete و fulfilment. تنها وضعیتی که باید تحویل را آغاز کند.
• Overpaid: paid با مازاد. مثل paid رفتار کنید و سیاست مازاد داشته باشید.
• Expired: پنجره بسته و unpaid. لغو و آزادسازی موجودی.
• Cancelled: عمداً رها شده. مثل expired.

callback redirect برای UX است نه مدرک پرداخت. تحویل را روی webhook یا status سمت سرور ببندید، نه روی بارگذاری URL در مرورگر.

انتخاب کوین و شبکه

گزینه بیشتر بهتر نیست. checkout با چهارده گزینه در منو بدتر از سه گزینه تبدیل می‌کند.

برای بیشتر فروشگاه‌ها با USDT TRC20، USDT BEP20 و در صورت نیاز USDC ERC20 شروع کنید. VisualPay را به ازای هر merchant فعال می‌کنید؛ چند فروشگاه هر کدام merchant جدا.

قیمت‌گذاری و کارمزد

VisualPay یک درصد ثابت برای هر تراکنش موفق می‌گیرد، بدون ماهانه و بدون کمیسیون payout. کارمزد را به خریدار یا merchant می‌توانید بدهید. مدل non-custodial است؛ بعد از آستانه معمولاً زیر یک دقیقه به آدرس شما می‌رود، فقط با کارمزد زنجیره.

قبل از اعلام تست کنید

1. سفارش واقعی کوچک؛ سفارش باید خودکار paid شود.
2. بگذارید منقضی شود؛ لغو و آزادسازی موجودی.
3. عمداً کمی کمتر بپردازید؛ رفتار حاشیه تحمل.
4. ایمیل تأیید و صفحه سفارش برای crypto منطقی باشد.
5. تسویه در کیف خودتان را ببینید، نه فقط «paid» در ادمین.

کدام مسیر

افزونه اگر ویترین استاندارد و سرعت مهم است. API اگر checkout سفارشی، headless، یا ماندن خریدار روی دامنه خودتان در مرحله پرداخت مهم است. هر دو همان درگاه و همان کیف‌ها را دارند؛ افزونه سرعت می‌دهد، API کنترل.