This guide walks you through installing and configuring the Haveno Payment Gateway Plugin for WooCommerce. By the end of this guide, your WooCommerce store will be able to accept anonymous cryptocurrency payments or fiat settlements through the Haveno decentralized payment network.

🔧 Plugin: HavenoPay for WooCommerce (Wordpress)

Status: In development
Version: 0.1.0 (Mocked Interface)

🛠️ Prerequisites

Before you begin:

  • A working WordPress + WooCommerce installation
  • Administrator access to your WordPress site
  • Provision a yourself VPS (optional but recommended) to run your Haveno Relay Node
  • A Tor binary installed, running and accessible if you want to route traffic over Tor

🚀 Step-by-Step Setup

1. Install the Haveno WooCommerce Plugin

Option A: From WordPress Plugin Directory (Coming Soon)

  1. Once published, search for "Haveno Payment Gateway" inside Plugins → Add New
  2. Click Install
  3. Then click Activate.
  4. You'll be redirected to the configuration screen immediately.

Option B: Manual Install

  1. Download the .zip release from https://haveno.com/downloads
  2. In your WordPress admin, go to Plugins → Add New → Upload Plugin
  3. Select the .zip file and click Install Now
  4. Click Activate Plugin after installation

2. Configure the Plugin

After activation:

  1. Go to WooCommerce → Settings → Payments → Haveno

  2. Click Manage

  3. Set the following:

    • Relay Node URL: Your relay’s onion address (or localhost if local)
    • Store Identity Key: A persistent private key used to sign webhook receipts
    • Supported Currencies: e.g., XMR, BTC, USD (via fiat settlement)
    • Webhook Secret (optional): HMAC secret for validating callbacks

  4. Save changes

  5. You can set to automatically sync products from your store to be viewed on the Haveno Marketplace too, subject to approval from moderation.

Shortly after you'll see your site appear as a merchant using Haveno DPG on the Haveno Merchants page where people can find your service website.

🌍 Setting up Your Haveno Relay Node

The Haveno Relay is a lightweight service that:

  • Connects to the Haveno P2P network
  • Relays signed payment offers and receipts
  • Subscribes to service-based liquidity events

You can run your relay locally or remotely:

Option A: Using Docker

git clone https://foss.haveno.com/haveno.git
cd haveno/relay
docker compose up  -d

Configure your .env to define:

Option B: Native Binary

cargo install haveno-relay
haveno-relay --config config.toml

Ensure your relay node is reachable by your WordPress instance. You may need to whitelist cloudflare, or configure WordFence or any other popular security plugins.

🔐 Security Tips

  • Always run your relay behind a reverse proxy or firewall
  • Use HTTPS or an Onion URL for the relay address
  • Regularly rotate webhook HMAC secrets
  • Use IP filtering if you want to limit relay access

🔄 How It Works

  1. Customer selects "Pay by Crypto or Bank Acount via Haveno" on checkout
  2. Haveno plugin fetches real-time payment routes and estimate completion time.
  3. A temporary smart offer is created in the P2P network
  4. The customer is shown instructions to complete payment
  5. Once confirmed, the relay notifies WooCommerce via webhook IPN.
  6. Order is marked Complete automatically

🧪 Testing

  1. Enable Test Mode in Haveno plugin settings
  2. Use a Haveno testnet wallet or faucet to simulate payments
  3. Review WooCommerce orders as normal

📎 Get Involved

Interested in helping build the plugin? Join our dev channel:

Ready to accept borderless, anonymous, decentralized payments? Haveno makes it possible, no banks (nessesarily), no accounts (at least not the once you're used to), no middlemen (unless you need help from a dispute).