Організації

Організація — це окремий проєкт/майданчик зі своїми гаманцями, мережами та налаштуваннями. Кожна організація має власний унікальний ідентифікатор (ID організації), який видно в картці.

Створити організацію

1. Перейдіть до розділу Організації.
2. Натисніть «+ Додати» і задайте назву.

Щоб відкрити налаштування — клацніть на картці організації. Усередині доступні вкладки: Загальні, Мережі, AML, Coins, API-ключі.

Info

Більшість чутливих полів (ключі, приватні ключі гаманців) приховані за замовчуванням — вони відображаються як зірочки. Щоб задати чи змінити значення, натисніть «Редагувати» біля відповідного поля.

Загальні

На вкладці «Загальні» налаштовуються базові параметри організації:

• Назва — відображувана назва організації (до 64 символів).
• URL вебхука — адреса, на яку платформа надсилає сповіщення про події (наприклад, про успішний або відхилений платіж). Вкажіть сюди адресу, на якій ваш сайт/сервіс приймає сповіщення.

Мережі

На вкладці «Мережі» ви налаштовуєте кожну блокчейн-мережу, у якій хочете приймати платежі. Мережі представлені окремими вкладками: TRC20, BEP20, ERC20, TON, ARBITRUM.

Для кожної мережі є блоки налаштувань. Набір полів залежить від мережі — наприклад, блок «Налаштування енергії» є лише для TRC20.

Блок «Загальні» (гаманці мережі)

• Адреса гаманця адміністратора — ваша постійна (основна) адреса в цій мережі. Саме сюди платформа переказує кошти після успішної AML-перевірки, і з неї ж ви потім виводите гроші на біржу чи зовнішній гаманець.
• Приватний ключ гарячого гаманця — налаштування «гарячого» гаманця. Він потрібен, щоб кожен платіж спершу приймався на окрему одноразову адресу, а після AML-перевірки автоматично переказувався на основний гаманець. Усі ключі ви задаєте самостійно.

Info

З міркувань безпеки приватний ключ гарячого гаманця після збереження відображається прихованим (зірочками). Щоб замінити його, натисніть «Редагувати» і введіть новий.

Блок «Налаштування енергії» (TRC20)

Для переказів у мережі Tron потрібна енергія. Доступні два провайдери оренди енергії — оберіть один:

• Netts
• ITRX

Для обраного провайдера вкажіть:

• API-ключ;
• Секретний API (Secret API).

Блок «Налаштування AML» (для цієї мережі)

• Увімкнути AML — перемикач перевірки вхідних платежів у цій мережі.
• Провайдер AML — постачальник AML-перевірок: BitOK або AMLBot (залежно від мережі).
• Макс. показник ризику (%) — верхня межа загального ризику (для TRC20 та подібних мереж).
• Макс. сигналів високого ризику (%) — верхня межа кількості сигналів високого ризику.
• Макс. рівень ризику AML — поріг, до якого платіж вважається допустимим. Доступні рівні: низький, середній, високий, критичний.
• Блокувати при потраплянні в чорний список — якщо увімкнено, платіж із адреси з чорного списку буде заблоковано незалежно від інших показників.

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

Warning

Жоден із провайдерів AML-перевірок наразі не підтримує перевірку для мережі TON.

Для провайдера BitOK набір полів AML спрощений — доступні лише перемикач AML, провайдер і макс. рівень ризику.

Info

Чим суворіший поріг (наприклад, «низький»), тим менше «ризикованих» платежів пройде автоматично. Адреси з білого списку AML пропускаються без перевірки.

AML

На вкладці «AML» зазначаються облікові дані AML-провайдерів на рівні організації. Платформа підтримує два провайдери — ключі для кожного задаються окремо:

BitOK:

• API-ключ;
• Секретний API.

AMLBot:

• ID доступу (Access ID);
• Ключ доступу (Access key).

Ключі AMLBot беруться на web.amlbot.com → Профіль → API ключі.

Ці ключі платформа використовує, щоб надсилати вхідні платежі на перевірку обраному провайдеру в налаштуваннях конкретної мережі.

Coins

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

• ID організації Hub;
• API-ключ депозиту Hub;
• API-ключ виведення Hub;
• Секрет вебхука Hub.

Заповніть усі чотири поля — вони працюють у зв'язці. Після збереження для організації стає доступним Coins-гаманець.

Info

Комісія. Під час зарахування коштів через Coins утримується комісія 0.2% від суми, але не менше ніж 0.5 USDT.

Коли кошти надходять через Coins, у розділі Адреси у колонці Баланс відображається конвертація — наприклад, 5 XRP → 5.56 ₮.

API-ключі

Вкладка «API-ключі» потрібна для інтеграції приймання платежів у ваш сайт чи сервіс. Тут ви бачите:

• UID організації — унікальний ідентифікатор вашої організації;
• Ключ вебхука — використовується для перевірки справжності сповіщень, які платформа надсилає на ваш URL вебхука;
• API-ключ — секретний ключ для звернень до API; можна здійснити перегенерацію

Warning

Важливо про перегенерацію. Новий API-ключ показується один раз одразу після генерації — скопіюйте та збережіть його. Старий ключ при цьому перестає працювати, тому оновіть його в усіх інтеграціях.

Якщо у вашому профілі увімкнено 2FA (TOTP), для перегенерації API-ключа потрібно буде ввести одноразовий код із застосунку-автентифікатора.

Білий список IP API-ключа

У нижній частині вкладки — білий список IP для API-ключа:

• якщо список порожній — API доступний з будь-якої IP-адреси;
• якщо додано одну чи кілька IP — запити до API прийматимуться лише з цих адрес.

Натисніть «+ Додати», щоб внести IP-адресу сервера, з якого працює ваша інтеграція.

Навіщо це потрібно. З цими даними ваша зовнішня система може автоматично:

• генерувати одноразові адреси під кожну заявку клієнта;
• запитувати баланс;
• ініціювати виведення та перевіряти їхній статус.

Тобто ви або вбудовуєте приймання платежів у власний сайт/обмінник, або вказуєте ці ключі у сторонньому сервісі (наприклад, у модулі криптообмінника), який працюватиме з платформою від вашого імені.

Депозит під подальшу виплату монети

POST /generate-disposable-address приймає необов'язкове поле payout_token_ticker — тікер монети, яку ви потім виплатите з цього депозиту.

• Поле не передано або порожнє: адреса лишається звичайною. main_address_type за замовчуванням MAIN. Стейблкоїни гарячого гаманця йдуть ончейн: USDT і USDC у TRC20, BEP20 та ARBITRUM; USDT, USDC, DAI, USDS і PYUSD у ERC20; USDT у TON.
• Поле передано, але тікера немає серед відомих монет (будь-яка мережа): поле ігнорується, адреса лишається звичайною. Новий токен при цьому не створюється. Так само для фіата, наприклад UAH.
• Якщо тікер відомий, адреса створюється як Coins, навіть коли main_address_type не передано або дорівнює MAIN. Депозит зараховується на віртуальний баланс USDT, щоб подальша виплата могла його витратити.

Виплата з цього депозиту передає source_order_id, що дорівнює order_id депозитної адреси. Тоді й стейблкоїн гарячого гаманця списується з віртуального балансу USDT. Окреме type=COINS у тілі виплати не потрібне: Coins обирається, коли є source_order_id або тікер виплати не входить до стейблкоїнів гарячого гаманця вище. Повторний запит на ту саму адресу з іншим payout_token_ticker і тим самим order_id конфліктує.