Appearance
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.