subscription.cancelled
subscription.cancelled is sent when a subscription moved to status cancelled: the merchant cancelled it in the panel with a reason from the list (and an optional comment), or with the bulk action on a product page — then the reason is product_discontinued; or the shopper cancelled it themselves — with or without a reason (then cancellation_reason: null). The reason is in the snapshot, in cancellation_reason; the comment is in status_reason. previous_status says whether the subscription was active or paused.
Neocarts never cancels a subscription itself: after the fifth failed attempt it pauses (subscription.paused with charge_failed). A cancellation is not final: the merchant (but not the shopper) can activate the subscription again from the panel — then subscription.resumed arrives with previous_status: cancelled.
Event fields
Section titled “Event fields”| Field | Type | Description |
|---|---|---|
previous_status |
string | active | paused — status before the cancellation |
reason_key |
null | always null; the cancellation reason is in the snapshot’s cancellation_reason |
The rest of data is the subscription snapshot.
Example
Section titled “Example”{ "id": "019a0b7c-1f3e-7c1a-9c6e-0b9b1c2d3e55", "event": "subscription.cancelled", "created_at": "2026-10-25T14:05:00+00:00", "shop_id": "7f3c2b1a-0d9e-4f8a-b7c6-d5e4f3a2b1c0", "data": { "id": "0199a1b3-5e6f-7a8b-9c0d-1e2f3a4b5c6d", "status": "cancelled", "status_reason": "Asked to cancel by phone", "cancellation_reason": "too_expensive", "product": { "id": "0199a1a0-2c3d-7e4f-8a5b-6c7d8e9f0a1b", "external_id": "SKU-1", "title": "Brit Care Adult Large Breed", "variant": "12 кг" }, "quantity": 1, "price": 249000, "discount_percent": 7, "interval_value": 4, "interval_unit": "week", "next_charge_at": "2026-11-01T09:00:00+00:00", "paused_until": null, "customer": { "id": "0199a1b5-1b2c-7d3e-8f4a-5b6c7d8e9f00", "first_name": "Олена", "last_name": "Коваль", "phone": "+380671234567", "locale": "uk" }, "delivery": { "provider": "nova-poshta", "type": "branch", "data": { "city": { "id": "…", "external_id": "8d5a980d-391c-11dd-90d9-001a92567626", "name": "Київ" }, "branch": { "id": "…", "external_id": "1ec09d88-e1c2-11e3-8c4a-0050568002cf", "name": "Відділення №1: вул. Пирогівський шлях, 135" } }, "recipient": { "first_name": "Олена", "last_name": "Коваль", "phone": "+380671234567" } }, "card": { "brand": "visa", "mask": "**** 4242" }, "created_at": "2026-10-04T09:12:30+00:00", "previous_status": "active", "reason_key": null }}What to do
Section titled “What to do”- Close the subscription in your system but keep the record:
subscription.resumedmay bring it back. cancellation_reasonis your churn analytics; the values are in enumerated values.null— the shopper gave no reason.- This event does not cancel the subscription’s open orders — follow those through
order.*.
Related events
Section titled “Related events”subscription.resumed— the cancellation was undonesubscription.paused— a temporary stop instead of a cancellationsubscription.price_changed— a reprice leaves cancelled subscriptions alone
Request headers, signature and retries are in the overview; the order of events is in the event flow.