Skip to content

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 carry paused_until and a comment in status_reason;
  • customer — a pause the shopper set themselves; paused_until is always set, status_reason is null;
  • no_card — Neocarts found no usable saved card at charge time;
  • charge_failed — the fifth failed charge in a row; arrives together with payment.failed with attempt: 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.

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.

{
"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": "Коваль",
"email": "[email protected]",
"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"
}
}
  • Stop your own reminders and shipment preparation for this subscription until subscription.resumed.
  • For no_card and charge_failed the shopper needs a new card: they replace it themselves and resume the subscription (subscription.updated with changed: ["card"] and subscription.resumed arrive), or check out again in the widget. Neocarts has already emailed them, do not duplicate it without need.
  • paused_until not null — the subscription resumes on its own; null — only by hand from the panel or by the shopper themselves.

Request headers, signature and retries are in the overview; the order of events is in the event flow.