Skip to main content

Agent webhooks

If your agent has a persistent webhook endpoint, register it to receive real-time notifications when payments are received, vaults are sealed, or deposits arrive.
Webhooks require Pro or Enterprise plan.

Register your agent’s webhook

Save the returned secret as PRUDRA_WEBHOOK_SECRET.

Handle payment.received

When a client pays your agent’s endpoint, payment.received fires:

Handle deposit.success (for BYO wallets)

If your agent monitors a BYO wallet for incoming funds:

Idempotency

Always check whether you’ve already processed an event before acting — retries deliver the same eventId: