Developer operations

Webhooks and Callbacks

Webhook delivery keeps external systems synchronized when payments initialize, complete, fail, refund, or reverse.

Plan this integration

Setup steps

  1. Register your callback URL.
  2. Verify signatures or shared secrets according to tenant policy.
  3. Return 200 responses only after storing the event.
  4. Monitor retries and reconcile failed deliveries.
node
app.post('/payments/webhook', express.json(), (req, res) => {
  savePaymentEvent(req.body);
  res.sendStatus(200);
});

FAQ

Should I trust a webhook alone?

No. Always verify status server-to-server for critical fulfillment.

Are retries supported?

Callback and delivery retry strategy is part of tenant setup.