subscription.updated
subscription.updated надсилається, коли підписку змінили, не змінюючи її статусу: продавець у панелі або сам покупець. Що саме — каже changed, одне з чотирьох значень:
["quantity"]— кількість одиниць на списання (лише панель);["interval_value", "interval_unit", "next_charge_at"]— графік: інтервал і дата наступного списання задаються разом; так само приходить пропуск доставки покупцем —next_charge_atзсувається на один інтервал, а скасування пропуску повертає його на пропущену дату;["delivery"]— адреса доставки: її змінили для підписки або покупець відредагував збережену адресу, на якій стоїть підписка;["card"]— покупець сам замінив картку; новіbrandіmask— уcardзнімка. Ту саму заміну супроводжуєpayment.refundedна 1 ₴ зorder_id: null.
Нові значення — у знімку; попередніх подія не несе. Зміна статусу — це subscription.paused, subscription.resumed і subscription.cancelled; зміна ціни — subscription.price_changed; зсув next_charge_at після оплати — subscription.renewed. Скасовану підписку так не змінюють — спершу її активують.
Поля події
Section titled “Поля події”| Поле | Тип | Опис |
|---|---|---|
changed |
string[] | які поля знімка змінилися: ["quantity"], ["interval_value", "interval_unit", "next_charge_at"], ["delivery"] або ["card"] |
Решта data — знімок підписки.
Приклад
Section titled “Приклад”{ "id": "019a0b7c-1f3e-7c1a-9c6e-0b9b1c2d3e56", "event": "subscription.updated", "created_at": "2026-10-18T11:20:00+00:00", "shop_id": "7f3c2b1a-0d9e-4f8a-b7c6-d5e4f3a2b1c0", "data": { "id": "0199a1b3-5e6f-7a8b-9c0d-1e2f3a4b5c6d", "status": "active", "status_reason": null, "cancellation_reason": null, "product": { "id": "0199a1a0-2c3d-7e4f-8a5b-6c7d8e9f0a1b", "external_id": "SKU-1", "title": "Brit Care Adult Large Breed", "variant": "12 кг" }, "quantity": 2, "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", "changed": [ "quantity" ] }}Що робити
Section titled “Що робити”- Перепишіть у своїй системі лише поля з
changed, беручи значення зі знімка; решту знімка можна теж оновити — він повний. ["delivery"]— нова адреса діє з наступного відвантаження; вже оформлене замовлення цієї підписки вона не змінює.["interval_value", …]— оновіть дату наступного списання зnext_charge_at, не обчислюйте її самі.["card"]— нічого списувати не треба: це лише нова картка для наступних списань; повʼязане повернення 1 ₴ у своєму обліку пропустіть.
Повʼязані події
Section titled “Повʼязані події”subscription.price_changed— зміна ціни — окрема подіяsubscription.renewed—next_charge_atзсунуто оплатою, а не вручнуsubscription.paused— зміна статусу — окремі події
Заголовки запиту, підпис і повтори — в огляді; порядок подій — у послідовності подій.