WooCommerce Integration

The PayzCore WooCommerce plugin adds USDT/USDC blockchain monitoring as a payment method in your WordPress store.

• Source: github.com/payzcore/woocommerce
• Requirements: WordPress 5.8+, WooCommerce 7.0+, PHP 7.4+, PayzCore account

How It Works

1. Customer selects "Pay with USDT/USDC" at checkout.
2. WooCommerce creates the order and the plugin calls the PayzCore API.
3. Customer sees the wallet address, QR code, and exact amount to send.
4. Customer sends stablecoins from their wallet.
5. PayzCore detects the transfer on-chain and sends a webhook.
6. Plugin receives the webhook and updates the order status to "Processing".

PayzCore monitors the blockchain for the transfer. The plugin does not handle any funds — it only reads the PayzCore API and updates WooCommerce order statuses.

Installation

1. Download the latest plugin ZIP from GitHub releases
2. In WordPress admin: Plugins > Add New > Upload Plugin
3. Upload the ZIP file and click Activate

Configuration

1. Go to WooCommerce > Settings > Payments
2. Enable PayzCore (USDT/USDC) and click Manage
3. Fill in the settings:

4. Click Test Connection. The plugin calls GET /api/v1/config to auto-detect the available chains and tokens from your connected wallet. The chain and token dropdowns are populated automatically — no manual selection is needed.

5. Set your webhook URL in the PayzCore dashboard to:

https://yourstore.com/?wc-api=payzcore

Order Status Mapping

Customer Experience

1. At checkout, customer selects the PayzCore payment method
2. After placing the order, they see:
   • The wallet address to send funds to
   • A QR code of the address (for mobile wallets)
   • The exact amount to send (in USDT/USDC)
   • A countdown timer showing time remaining
3. Customer sends the exact amount from their wallet
4. Once confirmed, the order automatically moves to "Processing"

Currency Handling

WooCommerce order total is sent to PayzCore in the store's base currency. PayzCore expects amounts in USD-pegged stablecoin terms:

• If your store currency is USD: Amount is used as-is (e.g., $50.00 order = 50 USDT)
• If your store uses other currencies: You must configure WooCommerce to display prices in USD, or the plugin sends the numeric total as stablecoins (e.g., 50 EUR order = 50 USDT request). Ensure your pricing accounts for this.

Troubleshooting

Webhook not received

• Verify the webhook URL in your PayzCore dashboard matches https://yourstore.com/?wc-api=payzcore
• Ensure your server allows POST requests from external sources
• Check for firewall rules or security plugins blocking external POST requests
• Review webhook delivery logs in PayzCore dashboard: Payments > [Payment] > Webhook Logs

Order not updating

• Confirm the Webhook Secret matches between PayzCore dashboard and WooCommerce settings
• Check WooCommerce logs: WooCommerce > Status > Logs (look for payzcore entries)
• Verify the plugin is activated and the payment method is enabled

Payment method not showing at checkout

• Ensure the plugin is activated in Plugins
• Ensure the payment method is enabled in WooCommerce > Settings > Payments
• Check that all required fields (API Key, Webhook Secret) are filled in and that Test Connection succeeds