Skip to Content
API ReferenceAPI Reference

API Reference

The TxNod REST API lets your server create invoices, manage webhook subscriptions, attribute orphan payments, and drive the sandbox simulation surface. Every call is signed with HMAC-SHA256 over X-Project-Id, X-Timestamp, and the request body — verified server-side with constant-time compare and a ±300s timestamp window. Invoice creation is idempotent on (project_id, external_id), so retries are safe. Errors carry stable typed codes; see the SDK error reference for the full enumeration.

  • Invoices — create, retrieve, search, and cancel invoices. Idempotent by external_id.
  • Inbound Webhooks — manage your project’s webhook subscriptions.
  • Orphan Payments — list and manually attribute on-chain transactions that did not auto-match an invoice.
  • Sandbox simulation API — drive every webhook event deterministically without on-chain spend.

Auth and signing

See API keys for key generation, rotation, and revocation. Sign every outbound request with the project secret; verify every inbound webhook with the verifyWebhookSignature SDK helper BEFORE parsing the body.

QuickstartInvoices