Skip to content

billing.payment_action_required ​

When: Your bank asks you to confirm an auto top-up (3-D Secure), which can't be done while you're away: open action_url to confirm it (once per payment). Auto top-up waits until it's confirmed; unconfirmed after a day it fails (billing.payment_failed)

Extra data: data is { account_id, payment_id, kind, amount, currency, action_url } — amount is what the balance gets

Example ​

Headers: X-Calloop-Event: billing.payment_action_required, X-Calloop-Event-Id, X-Calloop-Signature (verifying).

json
{
  "event_id": "7c0b1e0c-8a45-4c1b-9d4c-0f3a6a2f9b11",
  "event_type": "billing.payment_action_required",
  "api_version": "2026-09-25",
  "livemode": true,
  "occurred_at": "2026-09-25T10:05:12.000Z",
  "data": {
    "account_id": 4,
    "payment_id": 33,
    "kind": "AUTO_TOPUP",
    "amount": 20,
    "currency": "USD",
    "action_url": "https://pay.example.com/c/pay/cs_0033"
  }
}

No data.call: this event is about your billing account, not a call.