balance.low - Contro

Event: `balance.low`

Sent when your partner balance drops below the configured alert threshold. This check runs daily.

Payload

{
  "balance": 5000,
  "threshold": 10000,
  "currency": "USD"
}

Field	Type	Description
`balance`	number	Current balance in minor units (cents)
`threshold`	number	Alert threshold in minor units (cents). Default: 10000 ($100)
`currency`	string	ISO 4217 currency code

Response

Your endpoint must return a 2xx status code within 30 seconds to acknowledge receipt. Any non-2xx response or timeout triggers the retry policy.

Status code	Meaning
`200`	Event received and processed
`202`	Event received, will process asynchronously
Any non-2xx	Delivery failed — will retry

Example handler

app.post("/webhooks/contro", (req, res) => {
  const eventType = req.headers["x-contro-event"];

  if (eventType === "balance.low") {
    const { balance, threshold, currency } = req.body;
    // Alert your finance team to top up the balance
  }

  res.status(200).send("OK");
});