Метод для зміни статусу обробника угоди, що призводить до зміни статусу самої угоди. Статус обробника можливо отримати у відповіді при виклику Отримання даних по угоді, в полі - data.handler.status. Змінювати статус обробника угоди можливо лише у випадку, коли в угоді вказано користувацький тип обробника (наприклад data.handler.type=”Custom”) та статус обробника угоди - ‘CREATED', 'SENT' або 'DELIVERED' (це можливо лише після Підтвердження угоди). А змінити статус можливо лише на 'SENT', 'DELIVERED', 'FINISHED', 'CANCELED', 'REJECTED' або 'EXPIRED'.
Статуси обробника 'FINISHED', 'CANCELED', 'REJECTED' та 'EXPIRED' - фінальні, змінам не підлягають і призводять до зарахування/повернення грошей за товар і доставку.
Method | PATCH |
URL | /handlers/{{handlerType}}/status |
Поле | Обов'язковість | Тип | Опис | Приклад |
---|---|---|---|---|
{{handlerType}} | Так | String | Тип обробника | "Custom" |
dealId | Так | String | ID угоди | "L8M95ER" |
status | Так | String | Статус обробника. Може бути:
| “SENT“ |
statusCode | Нет | String | Статус код обробника в системі клієнта | “123“ |
statusText | Нет | String | Текстовий статус обробника в системі клієнта | “Посилка знаходиться в сортувальному центрі“ |
|
|
Поле | Опис |
---|---|
data | Об'єкт з відповіддю |
ID угоди | |
data.externalId | Зовнішній ID угоди |
Приклад:
|