Jetpay Developer Guide
Events and Webhooks
Quick Start
3 min
prerequisites before registering webhooks, you need a jetpay api authentication token (company token based access) a publicly accessible https endpoint to receive webhook events ability to respond to webhook requests within 15 seconds with a 2xx http status code quick start register your first webhook you can view our detailed schema for all webhook related api requests https //extapi jetpay baselinepayments com/docs#tag/webhooks (v0) to register a webhook endpoint, make a post request to the webhooks api endpoint post /webhooks/ minimum required parameters callback url your publicly accessible https endpoint the api will return a webhook configuration including a unique identifier that you'll use for management operations basic webhook handler requirements your webhook endpoint should respond quickly return a 2xx http status code within 15 seconds accept json expect content type application/json requests verify jwt validate the jwt token in the authorization header ( optional, but highly recommended) handle batches process arrays of events (1 to max batch size events per request) be idempotent handle duplicate event deliveries gracefully testing your endpoint before going live, ensure your endpoint is publicly accessible via https returns 2xx status codes for valid requests handles the expected event payload structure processes events asynchronously if needed (respond quickly, process later)
