subscription.paused
subscription.paused is sent when a subscription moved to status paused. Who paused it is in reason_key:
manual— the merchant in the panel (including the bulk action on a product page); the snapshot may carrypaused_untiland a comment instatus_reason;customer— a pause the shopper set themselves;paused_untilis always set,status_reasonisnull;no_card— Neocarts found no usable saved card at charge time;charge_failed— the fifth failed charge in a row; arrives together withpayment.failedwithattempt: 5.
No charges happen while paused. A pause is not a cancellation: the subscription comes back by hand or automatically once paused_until has passed, and then subscription.resumed arrives.
Event fields
Section titled “Event fields”| Field | Type | Description |
|---|---|---|
previous_status |
string | status before the pause: active |
reason_key |
string | manual | customer | no_card | charge_failed — the machine-readable reason; the human text is in the snapshot’s status_reason |
The rest of data is the subscription snapshot.
Example
Section titled “Example”{ "id": "019a0b7c-1f3e-7c1a-9c6e-0b9b1c2d3e53", "event": "subscription.paused", "created_at": "2026-10-20T08:30:00+00:00", "shop_id": "7f3c2b1a-0d9e-4f8a-b7c6-d5e4f3a2b1c0", "data": { "id": "0199a1b3-5e6f-7a8b-9c0d-1e2f3a4b5c6d", "status": "paused", "status_reason": "Holiday until mid-November", "cancellation_reason": null, "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": "2026-11-15T00:00:00+00:00", "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": "manual" }}What to do
Section titled “What to do”- Stop your own reminders and shipment preparation for this subscription until
subscription.resumed. - For
no_cardandcharge_failedthe shopper needs a new card: they replace it themselves and resume the subscription (subscription.updatedwithchanged: ["card"]andsubscription.resumedarrive), or check out again in the widget. Neocarts has already emailed them, do not duplicate it without need. paused_untilnotnull— the subscription resumes on its own;null— only by hand from the panel or by the shopper themselves.
Related events
Section titled “Related events”payment.failed— failed charges, the fifth of which pausessubscription.resumed— the subscription is active againsubscription.cancelled— a final stop instead of a pause
Request headers, signature and retries are in the overview; the order of events is in the event flow.