Skip to main content

Event Subscriptions and Callbacks

Through Webhooks, Real200 can send notifications to your server when specific events occur.

Supported Events​

Event TypeDescription
balance.lowBalance below threshold
quota.exceededKey quota exhausted
risk.alertRisk control alert
channel.downChannel unavailable

Configuration Steps​

  1. Go to Console Settings → Webhooks
  2. Click Add Webhook
  3. Fill in callback URL
  4. Select event types to subscribe to
  5. Save and test

Callback Format​

{
"event": "balance.low",
"timestamp": "2026-05-21T10:30:00Z",
"data": {
"balance": 50.00,
"threshold": 100.00,
"currency": "CNY"
}
}

Security Verification​

Webhook callbacks include a signature header. It's recommended to verify the signature to ensure the source is trusted:

X-Real200-Signature: sha256=...