Skip to content

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.

Calloop — the call engine behind your product.