Перейти до вмісту

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. Скасовану підписку так не змінюють — спершу її активують.

Поле Тип Опис
changed string[] які поля знімка змінилися: ["quantity"], ["interval_value", "interval_unit", "next_charge_at"], ["delivery"] або ["card"]

Решта data — знімок підписки.

{
"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": "Коваль",
"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",
"changed": [
"quantity"
]
}
}
  • Перепишіть у своїй системі лише поля з changed, беручи значення зі знімка; решту знімка можна теж оновити — він повний.
  • ["delivery"] — нова адреса діє з наступного відвантаження; вже оформлене замовлення цієї підписки вона не змінює.
  • ["interval_value", …] — оновіть дату наступного списання з next_charge_at, не обчислюйте її самі.
  • ["card"] — нічого списувати не треба: це лише нова картка для наступних списань; повʼязане повернення 1 ₴ у своєму обліку пропустіть.

Заголовки запиту, підпис і повтори — в огляді; порядок подій — у послідовності подій.