Prefund balance alert webhook

UR emits prefund.balance.alert when the balance of one settlement currency in the Prefund Account crosses its threshold. The alert is per currency and edge-triggered: UR sends it only when the level changes, not repeatedly while the balance sits below the threshold. UR signs the body with EIP-191; the partner must verify the signer against UR's public key, then treat the alert as a trigger (not as truth) and call Get Prefund balance to confirm current state before topping up.

Payload

Webhook envelope for Prefund balance level changes. UR signs the raw body with EIP-191; verify the recovered signer against UR's public key before acting on the payload.

eventconst: prefund.balance.alertRequired

Always prefund.balance.alert.

timestampinteger · int64Required

Unix seconds when the event was emitted.

Responses

200

Return HTTP 200 within 10 seconds to acknowledge delivery. UR retries non-200 or timed-out deliveries up to 3 times at 5-minute intervals.

No content

Payload

{
  "event": "prefund.balance.alert",
  "data": {
    "partnerId": "partner_id",
    "account": "0xPrefundAccAddress",
    "currency": "EUR",
    "balance": "18000.00",
    "minBalance": "20000.00",
    "previousLevel": "normal",
    "level": "warning",
    "updatedAt": 1713700000
  },
  "timestamp": 1713700005
}