Перехід з Beta

Останнє оновлення: 20 серпня 2026 р.

Ця стаття призначена для Організацій, створених за моделлю доступу Beta, де адміністратор надавав дозволи кожному Учаснику індивідуально. Тепер доступ формується на основі Профілів робочих процесів і Ролей облікових записів, а Kraken виконує конвертацію Вашої Організації автоматично.

Перед конвертацією зверніть увагу на два моменти:

  • Якщо Ви використовуєте API-ключі, перевірте їхню поведінку в Організації. Наявні виклики продовжують виконуватись на основному Обліковому записі. Використовуйте account_id, щоб вибрати інший Обліковий запис, і сприймайте успішний виклик виведення як запит, а не як підтвердження переміщення коштів. Докладніше — у розділі «Перегляд поведінки API» нижче.
  • Ми попросимо Вас підтвердити готовність. Конвертацію Організації буде розпочато лише після Вашого підтвердження.

Конвертація не скасовує жодного доступу. Усі дозволи кожного Учасника зберігаються.

Наявні API-ключі не відкликаються і не перевипускаються. Їхні облікові дані, дозволи та привʼязка до Облікових записів зберігаються. Наявні виклики, що не передають account_id, продовжують виконуватись на основному Обліковому записі Організації. Перевірте, як Ваша інтеграція обирає інший Обліковий запис і зчитує відповіді на запити виведення.

Вибір конкретного Облікового запису за потреби

Якщо account_id не вказано, приватний запит виконується на основному Обліковому записі:

bash

Bash

POST /0/private/AddOrder

Щоб виконати операцію на конкретному Обліковому записі, передайте account_id як параметр запиту в URL:

bash

Bash

POST /0/private/AddOrder?account_id=W5PB62NTPNYT6TYH

Передавайте його в URL, а не в тілі запиту. Явно вказаний account_id має пріоритет над резервним основним обліковим записом. Це не розширює привʼязку ключа до Облікових записів і не змінює його дозволи.

Ознайомтеся з новою відповіддю на запит виведення

WithdrawFunds повертає approval_request_id разом із refid:

bash

Bash

{
  "error": [],
  "result": {
    "refid": "FTcLNGa-4ZWmo4GCo8wrBNZz5v53v9",
    "approval_request_id": "656a021a-1d55-42c9-853a-aea57bf5abd1"
  }
}
  • Наявність refid більше не означає, що виведення завершено. Сума блокується на вихідному Обліковому записі в момент подання запиту й закривається лише після його схвалення.
  • approval_request_id — це ідентифікатор схвалення, якого очікує виведення. Збережіть його у своїх записах.
  • Виведення, що очікують схвалення, не відображаються у WithdrawStatus. Відхилений або прострочений запит не створює жодного запису про виведення, тому відсутність у WithdrawStatus не означає, що виведення не подавалося.

Автоматизація, яка сприймає refid як підтвердження завершення, відображатиме виведення як закриті, поки вони ще перебувають у черзі на схвалення. Повну модель описано в розділі Ключі API.

Після конвертації Ваша Організація отримує два набори стандартних будівельних блоків.

Workflow Profiles

Workflow Profile визначає, що Учасник може робити в кожному керованому робочому процесі. Кожен Учасник має рівно один профіль.

Профіль

Що включає

Адміністратор

Усі рівні в кожному робочому процесі, включно з Execute

Ініціатор

Перегляд та ініціювання в кожному робочому процесі. Не може схвалювати

Approver

Перегляд та схвалення в кожному робочому процесі. Не може ініціювати

Auditor

Перегляд у кожному робочому процесі. Не може діяти

Менеджер коштів

Перегляд, ініціювання та схвалення в запитах на виведення та переказ. Перегляд та ініціювання в розділі «Керування адресами»

Ролі облікових записів

Роль облікового запису визначає, що Учасник може робити з Вашими обліковими записами. Стандартні ролі поширюються на всі поточні та майбутні облікові записи — Учасник із роллю «Торгувати всім» зможе торгувати на обліковому записі, який Ви створите завтра.

Роль

Що надається для кожного облікового запису

Читати все

Прочитайте

Торгувати всім

Торгівля

Усі кошти

Переказ, виведення, Earn Allocate, Earn Deallocate

Повний доступ

Усі дозволи облікового запису

Стандартні профілі та ролі розвиваються разом із продуктом: щойно з'являється новий робочий процес, Учасники з відповідним профілем автоматично отримують потрібний рівень доступу. Повну модель описано в розділі Ролі, профілі та дозволи.

Якщо дозволи Учасника не відповідають жодному стандартному профілю, його переводять на роль із тим самим набором дозволів, який він мав. Учасники з однаковими дозволами отримують спільну роль, тож Ваша Організація матиме значно менше ролей, ніж Учасників.

Назви цих ролей формуються з позначок, які Ви вказували поруч із Учасником: наприклад, Учасник із позначкою «Trader» отримує роль trader. Учасники без позначки отримують роль migrated-role. Кожна така роль містить позначку migrated, яка означає, що назва згенерована автоматично та може бути змінена.

Порада.

Найкраще перше завдання після конвертації — перейменувати ці ролі відповідно до того, як Ви насправді називаєте цих людей. Редагування ролі знімає позначку migrated.

Чому Ваші Учасники з роллю «Admin» не перебувають у профілі Admin

Позначка «Admin» у бета-версії дозволяла переглядати, ініціювати та схвалювати запити, але не завершувати власні запити без другого схвалення. Профіль Admin включає цю можливість — рівень Execute.

Щоб не надавати цей рівень автоматично, Учасників зі старою позначкою призначено на роль beta-admin, яка містить саме ті дозволи, що вони вже мали. Перевести їх до Admin можна в будь-який момент — це одне призначення.

Примітка.

beta-admin — це одна з Ваших власних ролей, тому учасники, які її мають, не отримуватимуть нові робочі процеси автоматично, як це відбувається зі стандартними профілями. Це ще одна причина переглянути ці ролі невдовзі після конвертації.

Власника призначають на профіль Admin: він зберігає всі наявні права й автоматично отримує нові робочі процеси. Власник також має роль Read all, яку не можна видалити.

Якщо Ви навмисно обмежили права Власника, це рішення зберігається: Власника конвертують у роль із його фактичними правами — як і будь-якого іншого учасника.

  • Усі дозволи кожного Учасника зберігаються.
  • Облікові дані ключів API, права та маппінг облікових записів зберігаються.
  • Баланси, облікові записи та їх власність залишаються незмінними.
  • Запити на підтвердження, що вже перебувають в обробці, продовжують виконуватися; Ваші правила, порогові значення підтвердження та налаштування «завжди вимагати підтвердження» залишаються без змін.
  • Верифікація особи не змінюється — нікому не потрібно повторно входити або отримувати нове запрошення.
  • Конвертуються лише облікові записи, що належать Вашій Організації. Права на будь-який обліковий запис поза нею залишаються без змін.

Вирішення проблем

Виклики без account_id використовують основний обліковий запис Організації. Щоб звернутися до іншого облікового запису з маппінгу ключа, передайте його account_id у рядку URL. Див. розділ «Вибір конкретного облікового запису за потреби».

Виклик створив запит і заблокував суму на обліковому записі-джерелі. Закриття відбувається після підтвердження. Відстежуйте запит за approval_request_id, поверненим у відповіді на виклик, або знайдіть його на сторінці «Запити». Дивіться Перекази та виведення.

Учасники, чиї дозволи не відповідають жодному стандартному профілю, потребують окремої ролі, що зберігає їхній доступ; два учасники обʼєднуються в одну роль лише тоді, коли їхні дозволи збігаються повністю. Учасники, яким Ви призначили різні мітки, залишаються на окремих ролях навіть за однакових дозволів, оскільки різні мітки свідчать про навмисне розрізнення. Непотрібні ролі можна консолідувати, перепризначивши їхніх учасників і видаливши порожню роль.

Учасники, які адмініструють Організацію, — керують доступом команди, Обліковими записами або API-ключами, — отримують роль «Читати все», оскільки адміністрування Облікового запису передбачає можливість його переглядати. Якщо це ширше, ніж Вам потрібно, замініть «Читати все» на роль Облікового запису, обмежену конкретними Обліковими записами.

Ні. Конвертація є односторонньою. Усі результати конвертації можна редагувати після її завершення, тому будь-яке налаштування доступу, яке у Вас було, можна відтворити за допомогою профілів і ролей.