קבלת מונרו ב-WooCommerce: מדריך שילוב מלא

בעולם הסחר האלקטרוני המודרני, הפרטיות הפכה לערך מרכזי עבור קמעונאים ולקוחותיהם כאחד. מונרו (XMR) — מטבע הקריפטו הפרטי ביותר הקיים — מציע פתרון אידיאלי לעסקים שרוצים לאפשר תשלומים אנונימיים, מאובטחים וחסרי עמלות ביניים. שילוב מונרו ב-WooCommerce, פלטפורמת המסחר האלקטרוני הפופולרית ביותר בעולם, פותח דלת לשוק גדל של משתמשי קריפטו שמעדיפים פרטיות.

במדריך זה נעבור על כל השלבים הנדרשים: מהגדרת ארנק מונרו ועד להגדרת Webhook מתקדם ועיבוד החזרים. בין אם אתה בעל חנות קטנה או מפעיל פלטפורמת מסחר גדולה, תמצא כאן את כל המידע הנדרש להצלחה.

מדוע לקבל מונרו בחנות WooCommerce שלך?

לפני שנצלול לפרטים הטכניים, כדאי להבין מדוע מונרו הוא בחירה חכמה לעסקים:

• עמלות נמוכות: עסקאות מונרו כרוכות בעמלות נמוכות בהרבה מכרטיסי אשראי (1-3%) או PayPal. עמלת עסקת מונרו טיפוסית עומדת על פחות מ-$0.01.
• אין החזרות (Chargebacks): תשלומי קריפטו הם בלתי הפיכים — ברגע שהעסקה אושרה, אין סיכון להחזרה כפויה. זה מגן על בעל העסק מפני הונאות.
• שוק גדל: קהילת מונרו מונה מיליוני משתמשים ברחבי העולם שמחפשים אקטיבית מקומות לבזבז את ה-XMR שלהם.
• פרטיות הדדית: גם הלקוח וגם בעל העסק נהנים מפרטיות — לא נחשפות יתרות ארנק, היסטוריות עסקאות, או פרטים אישיים.
• ללא גבולות: קבל תשלומים מכל מקום בעולם ללא הגבלות מדינה, בנקאות, או בירוקרטיה.
• קשיח לצנזורה: בניגוד לחשבונות PayPal או Stripe שניתנים להקפאה, תשלומי מונרו אינם ניתנים לחסימה על ידי גורם שלישי.

דרישות מקדימות

לפני שמתחילים, ודא שיש לך את הדברים הבאים:

• WordPress מגרסה 6.0 ומעלה
• WooCommerce מגרסה 7.0 ומעלה
• שרת Linux עם גישת root (לאפשרויות מתקדמות)
• דומיין עם SSL תקף (HTTPS חובה)
• ארנק מונרו פעיל
• גישה ל-monero-wallet-rpc (לשיטות מתקדמות)

שיטות שילוב עיקריות

ישנן שלוש דרכים עיקריות לשלב מונרו ב-WooCommerce:

1. MoneroPay — פתרון קל ופשוט למפתחים
2. BTCPay Server — פתרון עצמאי ומלא עם תמיכה בריבוי מטבעות
3. שער תשלום מותאם אישית (Custom Gateway) — גמישות מקסימלית

שיטה 1: MoneroPay

MoneroPay הוא שרת תשלומים קל משקל המיועד ספציפית למונרו. הוא מספק API פשוט ויעיל לעיבוד תשלומים.

התקנת MoneroPay

ראשית, וודא שברשותך גרסת Go עדכנית. לאחר מכן הורד את MoneroPay:

git clone https://github.com/MoneroEcosystem/moneropay.git
cd moneropay
go build -o moneropay ./cmd/moneropay/

הגדר קובץ תצורה config.yaml:

daemon:
  address: "127.0.0.1:18081"
wallet:
  address: "127.0.0.1:18083"
  password: "your_wallet_password"
server:
  port: 5000
  host: "0.0.0.0"
callbacks:
  url: "https://your-store.com/wc-api/monero_payment"

הפעל את MoneroPay:

./moneropay --config config.yaml

יצירת פלאגין WooCommerce ל-MoneroPay

צור קובץ PHP חדש בתיקיית הפלאגינים של WordPress:

class WC_MoneroPay_Gateway extends WC_Payment_Gateway {
    public function __construct() {
        $this->id = 'moneropay';
        $this->method_title = 'Monero (XMR)';
        $this->init_form_fields();
        $this->init_settings();
        add_action('woocommerce_api_monero_payment',
                   array($this, 'handle_webhook'));
    }

    public function process_payment($order_id) {
        $order = wc_get_order($order_id);
        $amount = $this->convert_to_xmr($order->get_total());
        $response = wp_remote_post('http://localhost:5000/receive', [
            'body' => json_encode([
                'amount' => $amount,
                'callback_url' => WC()->api_request_url('monero_payment'),
                'description' => 'Order #' . $order_id
            ]),
            'headers' => ['Content-Type' => 'application/json']
        ]);
        if (!is_wp_error($response)) {
            $data = json_decode(wp_remote_retrieve_body($response));
            update_post_meta($order_id, '_xmr_address', $data->address);
            update_post_meta($order_id, '_xmr_amount', $amount);
            return [
                'result' => 'success',
                'redirect' => $this->get_payment_page_url($order_id, $data)
            ];
        }
    }
}

טיפול ב-Webhook

ה-Webhook מקבל התראות ממונפאי לגבי תשלומים שהתקבלו:

public function handle_webhook() {
    $payload = json_decode(file_get_contents('php://input'), true);
    $signature = $_SERVER['HTTP_X_MONEROPAY_SIGNATURE'] ?? '';
    if (!$this->verify_signature($payload, $signature)) {
        wp_die('Invalid signature', 403);
    }
    $order_id = str_replace('Order #', '', $payload['description'] ?? '');
    $order = wc_get_order($order_id);
    if (!$order) { wp_die('Order not found', 404); }
    $expected_amount = get_post_meta($order_id, '_xmr_amount', true);
    if ($payload['amount'] >= $expected_amount) {
        if ($payload['confirmations'] >= 10) {
            $order->payment_complete($payload['tx_id']);
            $order->add_order_note('תשלום XMR אושר. Hash: ' . $payload['tx_hash']);
        } else {
            $order->update_status('on-hold',
                'ממתין לאישורים: ' . $payload['confirmations'] . '/10');
        }
    }
    status_header(200);
    exit;
}

שיטה 2: BTCPay Server עם תמיכת מונרו

BTCPay Server הוא פתרון תשלומי קריפטו עצמאי ומלא. החל מגרסה 1.7, הוא תומך במונרו דרך Monero plugin רשמי.

הגדרת BTCPay Server

התקן BTCPay Server עם Docker:

git clone https://github.com/btcpayserver/btcpayserver-docker
cd btcpayserver-docker
export BTCPAY_HOST="btcpay.your-store.com"
export NBITCOIN_NETWORK="mainnet"
export BTCPAYGEN_CRYPTO1="xmr"
. ./btcpay-setup.sh -i

לאחר ההתקנה:

1. כנס לממשק BTCPay דרך הדפדפן
2. צור חנות חדשה ובחר "Monero" כמטבע
3. חבר את ארנק המונרו שלך דרך view key (מפתח צפייה בלבד לאבטחה)
4. התקן את פלאגין BTCPay ל-WooCommerce
5. הגדר את ה-API key ו-Store ID בהגדרות הפלאגין

יתרונות BTCPay Server

• ממשק ניהול מלא עם דוחות ועסקאות
• תמיכה בריבוי חנויות מאותו שרת
• מערכת Webhook מתקדמת עם retry logic
• תמיכה ב-Lightning Network לביטקוין
• קוד פתוח, מבוקר ומוכח
• קהילת מפתחים ותמיכה פעילה

שיטה 3: שער תשלום מותאם אישית

לעסקים עם צרכים ייחודיים, בניית שער תשלום מותאם אישית מציעה גמישות מקסימלית. זה מתאים לחברות עם צוות פיתוח פנימי ודרישות ייחודיות.

יצירת Subaddress לכל הזמנה

function create_xmr_subaddress($order_id) {
    $rpc_url = 'http://127.0.0.1:18083/json_rpc';
    $payload = json_encode([
        'jsonrpc' => '2.0',
        'id' => '0',
        'method' => 'create_address',
        'params' => ['account_index' => 0, 'label' => 'Order_' . $order_id]
    ]);
    $ch = curl_init($rpc_url);
    curl_setopt($ch, CURLOPT_POSTFIELDS, $payload);
    curl_setopt($ch, CURLOPT_HTTPHEADER, ['Content-Type: application/json']);
    curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
    curl_setopt($ch, CURLOPT_USERPWD, 'user:password');
    $response = json_decode(curl_exec($ch), true);
    curl_close($ch);
    return $response['result']['address'];
}

בדיקת תשלומים ב-Cron Job

add_action('check_xmr_payments', 'process_pending_xmr_payments');

function process_pending_xmr_payments() {
    $pending_orders = wc_get_orders([
        'status' => 'pending',
        'payment_method' => 'xmr_custom',
        'limit' => 50
    ]);
    foreach ($pending_orders as $order) {
        $xmr_address = $order->get_meta('_xmr_address');
        $expected_amount = $order->get_meta('_xmr_amount');
        $created_at = $order->get_date_created()->getTimestamp();
        if (time() - $created_at > 86400) {
            $order->update_status('cancelled', 'פג תוקף ההזמנה');
            continue;
        }
        $incoming = check_xmr_incoming($xmr_address, $expected_amount);
        if ($incoming['confirmed']) {
            $order->payment_complete();
            $order->add_order_note('תשלום XMR אושר');
        } elseif ($incoming['pending']) {
            $order->update_status('on-hold', 'תשלום XMR זוהה, ממתין לאישורים');
        }
    }
}

ניהול החזרים (Refunds)

החזרי מונרו שונים מהחזרים רגילים — אין מנגנון אוטומטי. לכן חשוב לבנות תהליך ברור:

1. אסוף כתובת ארנק מהלקוח בעת הגשת בקשת החזר דרך טופס ייעודי
2. בצע אימות — בקש מהלקוח לחתום הודעה בארנק כדי להוכיח בעלות
3. בצע העברה ידנית מארנק העסק לכתובת שסופקה
4. תעד ב-WooCommerce עם hash העסקה והערת הזמנה
5. שמור ראיות לצרכי מס ובקרה פנימית

אבטחה ושיטות עבודה מומלצות

שמירה על מפתחות

• לעולם אל תחשוף מפתח פרטי (private key) או seed phrase בשרת הוובסייט
• השתמש ב-view-only wallet לבדיקות נכנסות — כך השרת לא יכול להוציא כספים
• צור subaddresses חדשים לכל הזמנה ולעולם אל תשתמש שוב באותה כתובת
• אחסן ארנקים ראשיים ב-cold storage מחוץ לשרת

אבטחת שרת

• הפעל את monero-wallet-rpc מאחורי firewall — נגיש רק מ-localhost
• השתמש ב-HTTPS לכל תקשורת עם לקוחות
• חתום על Webhook payloads ואמת חתימות בקפדנות
• הגבל IP לשרתי webhook ידועים בלבד
• הפעל ניטור חריגות והתראות לפעילות חשודה

ניטור ותחזוקה שוטפת

• הגדר התראות אוטומטיות לעסקאות גדולות מסף מסוים
• בצע גיבויים יומיים של קובצי ארנק — גיבוי כפול במיקומים שונים
• עקוב אחר עדכוני מונרו — הפרוטוקול מתעדכן בכל 6 חודשים ועדכון ארנק חובה
• בדוק רשומות עסקאות שבועית ואמת שסכומים תואמים

המרת XMR לפיאט

אם אינך רוצה להחזיק XMR, תוכל להמיר אוטומטית לאחר קבלת תשלום. אפשרויות:

• API של בורסה מרכזית כמו Kraken, Binance, או KuCoin
• שירות המרה פרטיותי כמו MoneroSwapper לעסקאות שאינן דורשות KYC
• הגדרת סף המרה אוטומטית (כל $100 XMR מומר לדולר)
• שמירת אחוז כ-XMR להגנה מפני אינפלציה

השוואת פתרונות

שאלות נפוצות

כמה אישורים נדרשים?

בדרך כלל 10 אישורים (כ-20 דקות) מספיקים לרוב הרכישות. עסקאות גדולות מעל $500 עשויות לדרוש 20+ אישורים. ניתן לקבל עסקאות עם 0 אישורים לסכומים קטנים מאוד תמורת קבלת סיכון נמוך.

מה לגבי תנודות שער?

מחיר XMR משתנה. תמחר מוצרים בדולר וחשב את כמות ה-XMR בזמן אמת דרך API של CoinGecko או CryptoCompare. רוב הפלאגינים עושים זאת אוטומטית. ניתן גם לעדכן מחירים כל 5-15 דקות.

האם זה חוקי?

בישראל ובמדינות רבות קבלת קריפטו תמורת מוצרים ושירותים חוקית לחלוטין. עם זאת, יש לדווח על ההכנסות לצרכי מס — מטבעות קריפטו נחשבים נכס לפי רשות המסים הישראלית. היוועץ ברואה חשבון הבקיא בתחום הקריפטו.

מה קורה אם לקוח שלח כמות שגויה?

הגדר שולי סבלנות — בדרך כלל 1-2% חיובי ושלילי. תשלום חלקי יחזיר את ההזמנה למצב "ממתין" ויישלח מייל ללקוח. תשלום עודף ניתן לזכות ברכישה הבאה.

סיכום

שילוב מונרו ב-WooCommerce הוא השקעה טכנית שמשתלמת לעסקים שמעריכים פרטיות, מעוניינים להרחיב את בסיס הלקוחות לקהילת קריפטו, ורוצים להפחית עמלות עסקאות. בין אם תבחר ב-MoneroPay הפשוט, BTCPay Server המלא, או שילוב מותאם אישית — כל פתרון מציע רמת אוטומציה, אבטחה ובקרה שמתאימה לצרכים שלך.

עם הכלים הנכונים, חנות WooCommerce עם תמיכת מונרו תוכל לפעול ברמת אוטומציה מלאה — מקבלת תשלום, דרך אישור, ועד משלוח — ללא כל התערבות ידנית. זה לא רק עתיד הסחר האלקטרוני — זה כבר קורה היום. הצטרף לגל הגדל של עסקים שמאמצים תשלומי פרטיות ותן ללקוחותיך את הבחירה שהם מחפשים.