Accept Monero.Without Trusting Anyone.
Non-custodial, Tor-native payment processor for Monero merchants. No accounts. No custody. No surveillance.
// No logs. No fees. No trace.
AGPL-3.0 · Self-Hosted · 0% Fees
-H "Authorization: Bearer gb_live_..." \
-H "Content-Type: application/json" \
-d '{"amount_xmr": "0.5", "description": "VPN 1 month"}'}
{ "id": "inv_...", "address": "86jXqk...", "status": "pending" }
Protocol Snapshot
Lightweight. Predictable. Auditable.
Infrastructure You Control
Self-hosted, auditable, deterministic.
// SECURITY
Non-Custodial Core
GhostBill never holds private keys or funds. Payments go directly from customer to merchant wallet. No intermediaries. No custody risk.
// NETWORK
Tor-Native Infrastructure
Runs as a Tor hidden service by default. All outgoing connections routed through Tor. Privacy is the baseline, not an option.
// WEBHOOKS
Event-Driven API
17 webhook events covering the full invoice and subscription lifecycle. HMAC-SHA256 signed. 7 automatic retries. Build reactive systems without polling.
// INVOICES
Deterministic State Machine
7 invoice states with explicit transitions. Partial payments, overpayments, late payments — all handled automatically. No hidden failures.
// SUBSCRIPTIONS
Recurring Billing Engine
Customer management, automated renewal with configurable grace periods, 5-status subscription lifecycle. Deterministic billing anchors prevent drift.
// INFRA
Deploy Anywhere
Docker Compose deployment. 5 containers, 15 minutes setup. Runs on VPS, bare metal, or local node. No SaaS dependency. Ever.
How It Works
Four steps from deployment to payment.
Deploy
Run the Docker image. Configure wallet RPC. Expose as Tor hidden service.
Create Invoice
One API call generates a unique subaddress. Set amount, description, expiry.
Customer Pays
GhostBill monitors mempool and blockchain. Detects payments in seconds.
Receive Webhook
HMAC-signed event fires to your server. Verify, fulfill, done.
Deploy
Run the Docker image. Configure wallet RPC. Expose as Tor hidden service.
Create Invoice
One API call generates a unique subaddress. Set amount, description, expiry.
Customer Pays
GhostBill monitors mempool and blockchain. Detects payments in seconds.
Receive Webhook
HMAC-signed event fires to your server. Verify, fulfill, done.
Access Methods
Choose your connection layer. Privacy is the default.
Clearnet
- Standard HTTPS routing for high-speed API calls
- Cloudflare DDoS protection for public endpoints
- ghostbill.org / api.ghostbill.org
Endpoint Status: Active
api.ghostbill.orgTor Network
- End-to-end onion routing. No IP metadata leak.
- Native V3 hidden service for API + Dashboard.
- All outgoing webhooks routed through Tor.
Onion Status: Encrypted
bfmpzvpn53lky...uad.onionGhostBill does not collect IP addresses, cookies, or browser fingerprints on either access method. Tor provides maximum privacy — no third party sees your traffic. Clearnet routes through Cloudflare, which sees connection metadata. Your Monero transactions remain private regardless.
Deploy in 15 Minutes
Self-hosted. No accounts. No vendor lock-in.
Pull the Image
Run the official Docker Compose stack.
Configure Environment
Set RPC endpoint and wallet connection in .env file.
Launch the Service
Expose as Tor hidden service (recommended) or clearnet.
Create First Invoice
One API call. Start accepting Monero immediately.
AGPL-3.0
Open Source License
Free as in freedom.
FAQ
Technical questions answered.
Get in Touch
Integration questions, deployment support, or partnership inquiries.
Direct line for business inquiries, integration support, and partnership proposals.
[email protected] →GitHub Issues
Bug reports, feature requests, and technical discussions. Public and transparent.
Open an Issue →Matrix Room
Real-time community chat. Privacy-respecting, decentralized, no account required.
#ghostbill:matrix.org →Business inquiries typically answered within 24 hours.