Skip to main content
Paste this prompt into your coding agent when events are not arriving, or are arriving and failing verification. The agent works through the causes in order, from an unreachable endpoint to a re-serialized body, a prefixed secret, a rotation, and clock skew, and names the one that applies.

Before you start

  • One failing delivery from the Dashboard: its id, timestamp, and body.

Prompt

Prompt

How to use

  1. Collect one failing delivery from the Dashboard first — its id, timestamp and body. Debugging from logs alone costs an extra round.
  2. Rotate the signing secret yourself if step 4 is the suspect; the agent must not rotate credentials.
  3. Keep the replay script in the repo. Every webhook bug after this one is cheaper with it.

What the prompt builds

Webhooks

Event catalog, signatures, and retries.

Transactions

Transaction types and status progressions.

Integrate webhooks with signature checks

Receive signed events that survive retries and secret rotation.

Production readiness checklist

Audit a working Sandbox integration before real money moves.