API & Integrations
Webhook Configuration
Set up webhooks to receive real-time event data from Karsilo in your own applications.
Creating a webhook endpoint
Go to Settings → API → Webhooks and click 'Add Endpoint'. Enter the URL where Karsilo should send events. Your endpoint must accept POST requests and return a 200 status code within 30 seconds. We recommend using HTTPS for security.
Selecting events
Choose which events trigger webhook deliveries. Available events include: charge.succeeded, charge.failed, subscription.created, subscription.canceled, subscription.updated, invoice.paid, and daily_summary. Subscribe only to events you need to minimize unnecessary traffic.
Webhook security
Each webhook endpoint receives a unique signing secret. Karsilo includes a signature header with every delivery. Verify the signature in your application to ensure the request genuinely came from Karsilo. Our documentation provides verification code examples in Node.js, Python, Ruby, and Go.
Retry policy
If your endpoint returns a non-200 response or times out, Karsilo retries the delivery with exponential backoff. Retries occur at 1 minute, 5 minutes, 30 minutes, 2 hours, and 24 hours. After 5 failed attempts, the delivery is marked as failed. You can manually retry from the webhook logs.