Skip to content

docs: don't recommend a webhook timestamp tolerance by default - #3

Merged
samaxbytez merged 2 commits into
mainfrom
docs/webhook-tolerance-off
Nov 4, 2026
Merged

samaxbytez merged 2 commits into
mainfrom
docs/webhook-tolerance-off

Conversation

@samaxbytez

Copy link
Copy Markdown
Contributor

The webhook examples passed a 300-second timestamp tolerance, and the README called 300 a reasonable value. Nomba does not document whether automatic retries get a fresh nomba-timestamp. If they keep the original, a short tolerance would reject legitimate retries after an outage, and paid orders would never be confirmed.

  • Remove the tolerance from the README and examples/ webhook handlers.
  • Rewrite the tolerance text: dedupe on the signed requestId is the main defence; the tolerance stays off by default, and should only be enabled (generously) after confirming redeliveries carry a new timestamp.
  • Note that the amount, orderReference, merchantTxRef and tokenKey are not signed, so money decisions should be confirmed with transactions.get.

Docs only: no SDK code or defaults change (the tolerance was already off by default).

After this is merged and released, run node scripts/sync-sdk-references.mjs in the skills repo to refresh the nomba-webhooks skill references.

@samaxbytez
samaxbytez merged commit 3c7d296 into main Nov 4, 2026
5 checks passed
@samaxbytez
samaxbytez deleted the docs/webhook-tolerance-off branch November 4, 2026 01:14
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant