subscription.renewal-held
Receive this event when a previous renewal charge has an unknown outcome for your Telegram subscription bot or Discord subscription bot.
BotSubscription holds further renewal charges until that earlier attempt is resolved. Do not interpret the hold as a declined payment or start another charge yourself. Reconcile the referenced payment request when present, and contact support if the uncertainty persists.
Subscribe with an unrestricted project API key using subscription.renewal-held or subscription.*. See webhook registration for selectors and authentication.
Renewal hold payload
project_id, subscription_id, reason, and is_test are required. reason is renewal_charge_outcome_unknown. payment_request_id is optional and omitted when unavailable.
{
"id": "55555555-5555-4555-8555-555555555555",
"event": "subscription.renewal-held",
"created_at": "2026-11-16T12:00:00.000Z",
"schema_version": "v1",
"data": {
"project_id": "11111111-1111-4111-8111-111111111111",
"subscription_id": "66666666-6666-4666-8666-666666666666",
"payment_request_id": "77777777-7777-4777-8777-777777777777",
"reason": "renewal_charge_outcome_unknown",
"is_test": false
}
}Use signature verification before processing events, and deduplicate renewal hold notifications by the envelope's id.