Voodoo Token Payment Gateway (PulseChain)

Accept Voodoo Token (VDO) in WooCommerce with live pricing, locked order amounts, and automatic on-chain payment detection on PulseChain.

Repository: github.com/Voodoo-Token/voodoo-token-payment-gateway

---

Overview

This plugin adds a WooCommerce payment gateway for merchants who want to accept VDO on PulseChain (chain ID 369) without a third-party payment processor.

Customers see a live VDO estimate at checkout. When they place an order, the exact VDO amount is locked. After checkout they receive a clear payment screen with wallet address, QR code, and payment status polling.

The plugin verifies payments by reading VDO Transfer events on PulseChain and automatically marks orders as paid.

Official site: voodootoken.com

---

Features

• VDO payments on PulseChain only
• Configurable merchant wallet per store
• LiveCoinWatch live price conversion (store currency → VDO)
• Live estimate at checkout; amount locked when the order is placed
• Unique amount per order — safe for multiple customers paying at once
• Underpayment tolerance (0–10%, default 1%)
• Overpayments accepted — extra VDO stays in the merchant wallet
• Payment window with automatic expiry (default 60 minutes)
• On-chain verification via PulseChain RPC
• Classic + WooCommerce Blocks checkout
• WooCommerce logs (voodoo-vdo source)
• Copy-to-clipboard wallet address on the thank-you page

---

Requirements

Requirement	Version
WordPress	5.8+
WooCommerce	5.8+
PHP	7.4+ (BCMath or GMP recommended)
Merchant wallet	PulseChain 0x… address
LiveCoinWatch API key	Get free key

Hardcoded token details

Field	Value
Token	Voodoo Token (VDO)
Contract	0x1c5f8e8E84AcC71650F7a627cfA5B24B80f44f00
Decimals	18
Chain	PulseChain (369)
RPC	https://rpc.pulsechain.com

---

Installation

From ZIP

1. Install and activate WooCommerce
2. Upload voodoo-token-payment-gateway.zip via Plugins → Add New → Upload Plugin
3. Activate Voodoo Token Payment Gateway

From Git

cd wp-content/plugins/
git clone https://github.com/Voodoo-Token/voodoo-token-payment-gateway.git

Then activate the plugin in WordPress admin.

Configuration

1. Go to WooCommerce → Settings → Payments → Voodoo Token (VDO)
2. Enter your PulseChain merchant wallet
3. Enter your LiveCoinWatch API key
4. Set tolerance and payment window (optional)
5. Enable the gateway and save

Optional: default API key in wp-config.php

define('VOODOO_VDO_PG_LCW_DEFAULT_KEY', 'your-api-key-here');

---

How it works

Checkout → Live VDO estimate
    ↓
Place order → VDO amount locked on order
    ↓
Thank-you page → Wallet + QR + exact VDO amount
    ↓
Customer sends VDO on PulseChain
    ↓
Plugin polls chain (every 30s on thank-you page + cron every 2 min)
    ↓
Order marked paid → Processing/Completed

Payment matching rules

• Each order gets a unique locked VDO amount
• Multiple customers can pay at the same time safely
• Exact or slightly under (within tolerance) → order completes
• Overpayment → order completes; extra VDO noted in order comments
• Wrong network, wrong token, or wrong wallet → not detected

---

Recommended production setup

WordPress cron only runs when your site gets traffic. For reliable payment detection, add a real server cron:

*/2 * * * * cd /path/to/wordpress && wp cron event run --due-now >/dev/null 2>&1

Logs

WooCommerce → Status → Logs → select source voodoo-vdo

---

External services

This plugin connects to:

Service	Purpose
LiveCoinWatch API	Live VDO/fiat exchange rates
PulseChain RPC	On-chain payment verification
QR Server API	Payment QR image on thank-you page

No customer personal data is sent beyond what is required for pricing and blockchain lookups.

---

FAQ

What happens when payment is received?
The plugin detects the VDO transfer to your wallet, marks the order paid, and shows “Payment received” on the thank-you page.

Can two customers pay at the same time?
Yes. Each order has a unique locked amount. Transfers are matched to the closest order amount.

What if the customer sends too much VDO?
The order is marked paid. Extra VDO remains in your wallet (not auto-refunded).

What if the customer sends too little?
The order stays unpaid until tolerance is met or the payment window expires.

How fast is payment detected?
Usually 30–120 seconds if the thank-you page stays open; otherwise depends on cron.

---

Limitations

• VDO on PulseChain only (not Ethereum, BSC, etc.)
• No automatic refunds (manual only)
• No subscriptions or recurring payments
• Customers must send the exact locked amount for their order
• Low-traffic sites need a real cron job for background checks

---

Project structure

voodoo-token-payment-gateway/
├── voodoo-token-payment-gateway.php   # Bootstrap, REST, cron
├── README.md                          # This file (GitHub)
├── includes/
│   ├── class-voodoo-payment-gateway.php
│   ├── class-voodoo-price.php         # LiveCoinWatch pricing
│   ├── class-voodoo-chain.php         # PulseChain verification
│   ├── class-voodoo-blocks-integration.php
│   └── class-voodoo-logger.php
├── assets/
│   ├── css/
│   └── js/
├── readme.txt                         # WordPress.org readme
├── license.txt
└── uninstall.php

---

Development

Build ZIP (Windows)

.\build-zip.ps1

REST endpoints

Endpoint	Purpose
GET /wp-json/voodoo-vdo/v1/live-quote/	Live checkout estimate
GET /wp-json/voodoo-vdo/v1/order-status/	Payment status polling

---

Changelog

1.1.0

• WordPress.org readiness (index files, uninstall, settings link)
• Merchants use their own LiveCoinWatch API key
• Improved concurrent payment matching
• REST limited to VDO orders only

1.0.7

• Accept VDO overpayments

1.0.6

• Fix concurrent VDO payments (unique amounts + closest match)

1.0.5

• Simplified thank-you screen (one clear wallet address)

1.0.0

• Initial release

See readme.txt for the full WordPress.org changelog.

---

Contributing

1. Fork the repository
2. Create a feature branch: git checkout -b feature/my-change
3. Commit your changes and open a pull request

Please keep changes focused and test on a WooCommerce staging site before submitting.

---

License

GPLv2 or later — see license.txt and GNU GPL v2.

---

Support

• Website: voodootoken.com
• Issues: GitHub Issues

---

Built for the Voodoo Token community on PulseChain.