Webhooks troubleshooting and FAQ
Fix failed deliveries, URL errors, access problems and certificate issues.
My test or deliveries show Failed
Open the delivery (see View delivery logs) and check HTTP status and Response body:
| What you see | Usual cause |
|---|---|
4xx status | Your endpoint rejected the request (wrong path, authentication check, validation) |
5xx status | Your server errored or is unavailable |
| Very long Time taken | Your endpoint is timing out. Reply 2xx quickly and do heavy work in the background. |
Fix the endpoint, then use Retry or Bulk retry (see Retry failed deliveries).
I get "Enter a full URL with a valid domain"
Use a full public URL such as https://your-server.com/webhook. localhost, hostnames without a domain (e.g. http://myserver) and bare numbers are not accepted. To test locally, use a tunnelling tool that gives you a public HTTPS URL.
I can see subscriptions but not Add subscription or Edit
Your role has read-only Verto API access. Ask an admin for write access under Settings → Roles and permissions.
How do I stop receiving events?
Edit the subscription and turn off Activate this webhook subscription. Subscriptions can't be deleted. See Manage webhook subscriptions.
How far back can I retry?
Bulk retry covers up to the last 14 days.
I generated a new webhook certificate and verification broke
A new certificate replaces the old one. Download the new .pem from Webhook certificates and deploy it to your server. See Webhook certificates.
Where are the event payload formats?
In the API reference, for example wallet_credit_success.
Updated 14 days ago