Appearance
billing.payment_failed
When: A payment failed — an auto top-up's card declined, or it couldn't be charged without a billing address for its tax (once per payment)
Extra data: data is { account_id, payment_id, kind, amount, currency, reason }
Example
Headers: X-Calloop-Event: billing.payment_failed, X-Calloop-Event-Id, X-Calloop-Signature (verifying).
json
{
"event_id": "7c0b1e0c-8a45-4c1b-9d4c-0f3a6a2f9b11",
"event_type": "billing.payment_failed",
"api_version": "2026-09-25",
"occurred_at": "2026-09-25T10:05:12.000Z",
"data": {
"account_id": 4,
"payment_id": 32,
"kind": "AUTO_TOPUP",
"amount": 20,
"currency": "USD",
"reason": "Your card was declined."
}
}No data.call: this event is about your billing account, not a call.