From b7d9d97ab7ddb4b8d6cd5372dbf8489ea7c721f0 Mon Sep 17 00:00:00 2001 From: jwinterm Date: Wed, 18 Mar 2026 13:18:25 -0400 Subject: [PATCH] docs: add webhook and extra_hosts documentation --- README.md | 12 ++++++++++++ 1 file changed, 12 insertions(+) diff --git a/README.md b/README.md index f340549..add85eb 100644 --- a/README.md +++ b/README.md @@ -148,6 +148,18 @@ If you’re running the bundled `monerod` service: docker compose --profile local-daemon up --build -d ``` +### Webhooks to external systems + +xmrcheckout can send BTCPay-compatible webhooks when invoice status changes (e.g., payment confirmed on-chain). Configure webhooks per-merchant via the admin panel or merchant dashboard. + +If the webhook target is on the same LAN and Docker containers cannot resolve its hostname (NAT hairpinning), add `extra_hosts` to the `reconciler` service in `docker-compose.yml`: + +```yaml +reconciler: + extra_hosts: + - "api.example.com:192.168.1.100" +``` + ### Optional: Postgres backups (disabled by default) This repository includes an optional `db-backup` service that runs `pg_dump` hourly and writes backups to `./backups/postgres` on the host.