DeroPay

Accept DERO payments in minutes.

Invoices, real-time payment monitoring, HMAC-signed webhooks, and a self-hosted merchant dashboard. Everything runs on your infrastructure.

Zero platform feesSelf-hostedMIT licensed
Aurora Storeinvoice #DP-2048
Awaiting payment
25.00000DERO
≈ expires in 14:58
Scan to pay
Point any DERO wallet at the code. The integrated address embeds the payment ID — no memo to copy.
Integrated addressdero1qy…8f3a2c
3 / 5 confirmations
Lifecycle

Invoice to confirmation

The complete payment lifecycle — creation, QR, detection, and chain confirmations — handled by the engine.

01

Create invoice

Unique integrated address with TTL expiry and full state-machine lifecycle.

02

Customer pays

They scan the QR from any wallet. No payment ID to copy by hand.

03

Detect payment

Polling detection at your configured confirmation depth via daemon topo height.

04

Webhook fires

HMAC-signed POST on every state change, with exponential-backoff retries.

Features

Everything a merchant needs

From invoice creation to webhook delivery. No third-party services, no API keys, no external dependencies.

Invoice Engine

Unique integrated addresses, automatic TTL expiry, partial-payment handling, and a full state-machine lifecycle.

QR Code Payments

Customers scan with their wallet. Integrated addresses embed payment IDs — no manual input needed.

Real-Time Monitoring

Polling detection with configurable confirmation depth using daemon topo height vs. the transfer’s inclusion height.

HMAC Webhooks

Stripe-style signed HTTP POST on every state change, with exponential-backoff retry.

Pluggable Storage

In-memory for dev, SQLite for production, or bring your own via a simple InvoiceStore interface.

Merchant Dashboard

Self-hosted admin UI for invoices, payment history, wallet status, and escrow operations.

Accept DERO everywhere

Four ways to get paid

One gateway server, multiple distribution channels. Pick the one that fits your business — or use them all.

Payment Links

No website needed. Create an invoice, get a link, share it anywhere — email, social, QR poster, text. The hosted checkout page handles the rest.

Embeddable Widget

Drop a single <script> tag on any website. A 14 KB file renders a “Pay with DERO” button with a full payment modal. Zero dependencies.

WooCommerce Plugin

Accept DERO in the world’s largest ecommerce platform. A thin PHP adapter connects your WooCommerce checkout to the gateway’s REST API.

Medusa.js Plugin

TypeScript-native payment provider for Medusa v2. Extends AbstractPaymentProvider with automatic fiat-to-DERO conversion and webhook handling.

Quick start

Five minutes to first payment

Configure your wallet RPC, create an invoice, and start monitoring.

server.ts
import { InvoiceEngine } from "dero-pay/server";
import { deroToAtomic } from "dero-pay";

const engine = new InvoiceEngine({
  walletRpcUrl: "http://127.0.0.1:10103/json_rpc",
  daemonRpcUrl: "http://127.0.0.1:10102/json_rpc",
  store: new SqliteInvoiceStore("./payments.db"),
  webhook: {
    url: "https://mystore.com/api/webhook",
    secret: process.env.WEBHOOK_SECRET!,
  },
});

const invoice = await engine.createInvoice({
  name: "Premium Plan",
  amount: deroToAtomic("25.0"),   // 25.00000 DERO
  ttl: 900,                    // 15 minutes
});

engine.start();

Ready to accept DERO?

Start accepting private payments in minutes. Self-hosted, zero platform fees, fully open source.