1. Core Architecture: How ZeroBeep Operates
ZeroBeep is a pure decentralized, non-custodial gateway for WooCommerce. Unlike BitPay, CoinGate, or Coinbase Commerce, ZeroBeep never intercepts your cryptocurrency, holds customer balances, or routes funds through a centralized third party.
Direct Peer-to-Peer Settlement
- Zero Intermediary Accounts: Funds travel directly across the blockchain from the customer's wallet straight to your private receiving address.
- 0% Platform Commission: ZeroBeep charges zero percentage fees on orders. You keep 100% of your sales volume.
- Cold Storage Compatible: You can paste public addresses or extended public keys (xPub) from hardware wallets (Ledger, Trezor, Keystone, Tangem) without your private keys ever touching a web server.
2. General Configuration Core Free
Navigate to wp-admin > ZeroBeep > Settings > General to establish your store's core transaction rules.
| Field Name | Default | Recommended Setting & Operational Rationale |
|---|---|---|
| Payment Expiration (Minutes) | 60 | 15 to 30 minutes for volatile assets (BTC, ETH, SOL) to mitigate price volatility. 60 minutes for stablecoins (USDT, USDC). |
| Price Exchange Oracle | CoinGecko | Queries live market spot prices every 5 minutes and caches rates locally to avoid checkout rate-limit delays. |
| Underpayment Tolerance (%) | 0.00% | Allows orders to complete automatically if a customer accidentally underpays due to miner fees (e.g. 0.5% tolerance). |
| Overpayment Action | Mark Processing | Automatically completes order and logs excess satoshis/wei in order notes for administrative review. |
| Order Status on Detect | On-Hold | Transitions order to On-Hold as soon as an unconfirmed transaction appears in the blockchain mempool. |
| Order Status on Finalize | Processing | Transitions order to Processing or Completed once the target block confirmations are reached. |
3. Supported Blockchains & Currency Setup
Configure wallet receiving addresses under ZeroBeep > Settings > Currencies.
| Blockchain / Currency | Edition | Address Format Required | Recommended Confirmation Target |
|---|---|---|---|
| Bitcoin (BTC) | Free | Native SegWit (bc1q...) or Taproot (bc1p...) |
1-2 Confirmations |
| Ethereum (ETH) | Free | Standard EVM (0x...) |
12 Confirmations (PoS finality) |
| Litecoin (LTC) | Free | Bech32 (ltc1...) or SegWit (M...) |
2-4 Confirmations |
| Dogecoin (DOGE) | Free | Standard Legacy (D...) |
4-6 Confirmations |
| USDT / USDC (ERC-20) | Free | Standard EVM (0x...) |
12 Confirmations |
| Solana (SOL & SPL-USDC) | Pro | Base58 Solana address (Phantom / Solflare) | Confirmed / Finalized (3-5 seconds) |
| Tron (TRX & USDT-TRC20) | Pro | Base58 Tron address (T...) |
19 Confirmations (Sub-cent fees) |
| Base (Coinbase L2) | Pro | Standard EVM (0x...) |
1 Confirmation (Sub-cent fees) |
| Arbitrum One (L2) | Pro | Standard EVM (0x...) |
1 Confirmation |
| Polygon PoS (MATIC) | Pro | Standard EVM (0x...) |
64 Confirmations (State sync) |
| Monero (XMR) | Pro | Standard or Integrated 95-char address (4... or 8...) |
10 Confirmations |
4. HD Wallet Extended Public Keys (xPub / zPub) Pro
To prevent customer address reuse and protect your financial privacy, ZeroBeep PRO derives a brand new, unused receiving address for every individual checkout order.
Security Assurance: Read-Only Public Keys
An extended public key (xPub, yPub, or zPub) can only *derive* public child addresses. It possesses mathematically zero ability to spend, sign, or move funds. Your private keys never leave your Ledger, Trezor, or software wallet.
How to Configure BIP32/BIP44 HD Derivation:
- Open your hardware or software wallet (Ledger Live, Trezor Suite, Electrum, Sparrow, or BlueWallet).
- Navigate to Account Details > Advanced > Extended Public Key.
- Copy your
zpub...(Native SegWit Bech32) orxpub...(Legacy). - In WordPress Admin, go to
ZeroBeep > Settings > HD Wallets. - Paste your key into the Bitcoin or EVM xPub field.
- ZeroBeep automatically verifies derivation index #0 and prompts you to confirm that the generated address matches the first address in your wallet.
5. Outgoing Signed Webhooks Pro
Connect ZeroBeep directly to external fulfillment engines, Zapier, Make.com, ERPs, or custom web services using HMAC-SHA256 authenticated webhooks.
Configure webhook endpoints under ZeroBeep > Settings > Webhooks:
| Event Name | Trigger Moment | Payload Contents |
|---|---|---|
payment.detected |
Transaction first detected in mempool (0 confirmations). | Order ID, txHash, currency, amount received, customer email. |
payment.confirmed |
Target block confirmations reached. Order moved to Processing. | Order ID, txHash, block number, confirmations, settlement timestamp. |
payment.underpaid |
Payment received is less than total minus tolerance. | Order ID, expected amount, received amount, deficit satoshis/tokens. |
payment.expired |
Timer elapsed before transaction was broadcast. | Order ID, expiration time, cleanup status. |
refund.requested |
Customer submits a self-service refund request via shortcode. | Order ID, return address, reason, timestamp. |
refund.completed |
Admin executes refund payout ledger item. | Order ID, refund txHash, payout amount, admin note. |
HMAC-SHA256 Signature Verification
Every outgoing request includes header X-ZeroBeep-Signature: sha256=... generated using your Webhook Secret. Validate this hash on your receiving server before processing automated fulfillment to prevent spoofing or replay attacks.
6. Customer Self-Service Refund Portal Pro
Allow buyers to request refunds without sharing private keys or sending back-and-forth support emails.
- Create a new WordPress page titled "Crypto Refund Request".
- Insert shortcode:
[zerobeep_refund] - Publish the page. Customers can enter their WooCommerce Order Number and Billing Email to review order status and submit a designated refund receiving address.
- Admins view pending requests in
ZeroBeep > Refundswith 1-click batch export and blockchain verification links.
7. Accounting CSV Reports & Diagnostic Audits
Export clean, tax-compliant records under ZeroBeep > Reports. Filter by date range, blockchain rail, currency, or order status. Exports include:
- WooCommerce Order ID & Customer Billing Country
- Fiat Total (USD/EUR) & Crypto Total (BTC/ETH/USDT)
- Exchange Rate Oracle Used & Price Timestamp
- On-Chain Transaction Hash (txHash) with clickable block explorer links
- Mining / Network Fees Deducted (if tracked)