> For the complete documentation index, see [llms.txt](https://docs.merchant.alb.ua/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.merchant.alb.ua/platizhni-metodi-h2h/recurring-payment/redaguvannya-versiyi.md).

# Редагування версії

Редагувати можна **тільки останню версію** плану, і обсяг дозволених змін залежить від її поточного стану

**Що можна змінити залежить від стану версії:**

<table data-header-hidden><thead><tr><th width="164.758056640625"></th><th width="228.0614013671875"></th><th></th></tr></thead><tbody><tr><td><strong>Стан версії</strong></td><td><strong>Дозволено змінити</strong></td><td><strong>Бізнес потреба</strong></td></tr><tr><td>Ще не почалась</td><td><code>appliesDateTimeFrom</code>, <code>appliesDateTimeTo</code></td><td><ol><li>Зміна дати завершення версіі</li><li>Зміна дати початку версіі (з автоскороченням активної)</li></ol></td></tr><tr><td>Вже діє</td><td>Тільки <code>appliesDateTimeTo</code></td><td><ol><li>Продовження терміну дії версіі</li><li>Скорочення терміну дії</li></ol></td></tr></tbody></table>

Параметри `coinAmount`, `intervalUnit`, `intervalValue` — НЕ редагуються. Якщо потрібно змінити суму або частоту — створюється **нова версія** плану ендпоітом [Редагування плану та додавання нової версіі](/platizhni-metodi-h2h/recurring-payment/redaguvannya-planu-ta-dodavannya-novoyi-versii.md)

Після будь-якого редагування графік ще не виконаних (`WAITING`) платежів автоматично перебудовується — вже виконані списання це не зачіпає.

#### Вхідні параметри:  <a href="#vkhidni-parametri" id="vkhidni-parametri"></a>

| **Параметр**        | **Опис**                      | **Формат даних** | **Обовʼязковість**                                     | **Приклад**                  |
| ------------------- | ----------------------------- | ---------------- | ------------------------------------------------------ | ---------------------------- |
| planId              | Id плану                      | uuid             | так                                                    |                              |
| versionId           | Id версіі                     | int              | так                                                    |                              |
| infiniteVersion     | ознака нескінченності версіі  | boolean          | ні, по дефолту false                                   | true                         |
| appliesDateTimeFrom | зміна версії застосовується з | TIMESTAMPZ       | ні, якщо параметр не передано, то нічого не змінюється | 2026-02-26 11:23:45.12+02:00 |
| appliesDateTimeTo   | версія застосовується до      | TIMESTAMPZ       | ні, якщо параметр не передано, то нічого не змінюється | 2026-02-26 11:23:45.12+02:00 |

#### Вихідні параметри:  <a href="#vikhidni-parametri" id="vikhidni-parametri"></a>

<table data-header-hidden data-search="false"><thead><tr><th></th><th></th><th></th><th></th></tr></thead><tbody><tr><td><strong>Параметр</strong></td><td><strong>Опис</strong></td><td><strong>Формат даних</strong></td><td><strong>Приклад</strong></td></tr><tr><td>planId</td><td>Id плану</td><td>uuid</td><td> </td></tr><tr><td>versionId</td><td>Id версіі</td><td>int</td><td>1</td></tr><tr><td>rules.paymentNumberFrom</td><td>початковий номер платіжа з якого почина діяти дане правило</td><td>integer</td><td>1</td></tr><tr><td>rules.paymentNumberTo</td><td>останній номер платіжа для якого ще працює правило</td><td>integer</td><td>1</td></tr><tr><td>rules.intervalValue</td><td>Значення білінг-інтервалу</td><td>integer</td><td>1</td></tr><tr><td>rules.intervalUnit</td><td>Одиниця білінг-інтервалу</td><td>string</td><td>MONTH</td></tr><tr><td>rules.coinAmount</td><td>сума</td><td>long</td><td>10</td></tr><tr><td>rules.currency</td><td>валюта</td><td>string</td><td>980</td></tr><tr><td>appliesDateTimeFrom</td><td>зміна застосовується з</td><td>TIMESTAMPZ</td><td>2026-02-26 11:23:45.12+02:00</td></tr><tr><td>appliesDateTimeTo</td><td>зміна застосовується до</td><td>TIMESTAMPZ</td><td>2026-02-26 11:23:45.12+02:00</td></tr><tr><td>createdAt</td><td>Дата та час створення версіі</td><td>TIMESTAMPZ</td><td>2026-02-26 11:23:45.12+02:00</td></tr><tr><td>updatedAt</td><td>Дата та час останнього оновлення версіі</td><td>TIMESTAMPZ</td><td>2026-02-26 11:23:45.12+02:00</td></tr></tbody></table>

#### &#x20;Приклад запиту

```json
{
   "planId":"{{planId}}",
   "versionId":"4",
   "infiniteVersion":"false",
   "appliesDateTimeTo": "2026-10-18 13:46:00.52+03:00",
   "appliesDateTimeTo": "2026-12-18 13:46:00.52+03:00"
}
```

#### &#x20;Приклад відповіді

```json
{
    "planId": "a9562240-10ca-42d7-8d90-bbd1ace3dc5a",
    "versionId": 4,
    "rules": [
        {
            "paymentNumberFrom": 1,
            "paymentNumberTo": 3,
            "intervalValue": 1,
            "intervalUnit": "DAY",
            "coinAmount": 205,
            "currency": "980"
        },
        {
            "paymentNumberFrom": 4,
            "paymentNumberTo": 6,
            "intervalValue": 1,
            "intervalUnit": "MONTH",
            "coinAmount": 8000,
            "currency": "980"
        }
    ],
    "appliesDateTimeFrom": "2026-10-18 13:46:00.52+03:00",
    "appliesDateTimeTo": "2026-12-18 12:46:00.52+02:00",
    "createdAt": "2026-07-10 11:59:54.48+03:00",
    "updatedAt": "2026-07-10 12:10:34.14+03:00"
}
```