API Reference
Manage webhook endpoints
Register, test, and remove webhook endpoints in the portal.
Register an endpoint
Webhook endpoints are managed from the merchant portal at zippypay.io. There are no public API routes for webhook registration — complete business verification (KYB) in the portal first.
- Open Developer → Webhooks in the portal.
- Register an HTTPS URL (normalized; each active URL must be unique per business).
- Copy the one-time signing secret
whsec_....
Test an endpoint
Use the portal test action to send a signed sample delivery to your URL. Test payloads include data._test = true so you can validate connectivity and signature verification before go-live. See signature verification.
Rotate or remove
To rotate a signing secret, register a new endpoint, update your receiver, then purge the old endpoint from the portal. Purging stops future deliveries to that URL.