Webhooks
Know the moment something happens.
Rather than polling for status, register an endpoint and receive a signed event when a payment succeeds, a payout completes, or a virtual account is credited.
Setting up
Four steps to reliable event handling.
- 1
Register
Add your HTTPS endpoint under Developer settings in the dashboard.
- 2
Verify
Check the signature on every request against your secret key before trusting it.
- 3
Acknowledge
Return a 200 quickly, then do your work asynchronously.
- 4
Reconcile
Treat events as idempotent — the same event may legitimately arrive twice.
What to expect
Designed so a dropped request never loses money.
- Events are retried until your endpoint acknowledges them
- Every payload is signed so you can reject anything unsigned
- Delivery attempts are visible in the dashboard for debugging
- Sandbox fires the same events as production
- Payment, payout, refund and virtual account credit events are covered
See the webhook reference.
Event shapes and signature verification are documented in full.
Open documentationReady to build on infrastructure you can grow with?
From your first transaction to your next million, SaySwitch gives you the infrastructure to accept payments, move money, and grow with confidence.