# Массовые выплаты в криптовалюте партнёрам и подрядчикам

> Выплаты партнёрам и подрядчикам в USDT и других активах — файлом CSV до 1 000 строк или через API с вашим payout_id. Проверка до списания, одно 2FA, без дублей.

Source: https://cryptolike.net/ru/use-cases/mass-payouts
Updated: 2026-10-01

CryptoLike отправляет выплаты в криптовалюте многим получателям с одного баланса. Загрузите в кабинете файл CSV до 1 000 строк или создавайте выплаты по одной через API со своим `payout_id`. Каждая строка проверяется до того, как деньги сдвинутся, весь файл подтверждается одним кодом 2FA, а повторный запрос никогда не заплатит дважды.

## Почему массовые выплаты в криптовалюте — это риск?

Выплаты партнёрам и подрядчикам вручную — это копирование адресов и сумм по одному, и один неверный символ отправляет деньги на адрес, откуда их не вернуть. CryptoLike добавляет проверки, которые нужны финансовой команде: валидацию, расчёт комиссий, белый список адресов и второе подтверждение.

Что ломается при ручных выплатах: опечатка в одном адресе из сотен, выплата, остановившаяся на середине, повтор, который платит одному человеку дважды, комиссия сети, известная только после отправки, и один сотрудник, который может перевести крупную сумму сам.

## Как работает пакетная выплата CryptoLike

Пакетная выплата CryptoLike — это файл CSV, загруженный в кабинете (Выплаты → Пакеты). Файл проверяется целиком до создания чего-либо: корректный файл создаёт все выплаты в одной транзакции базы данных, некорректный — ни одной. Один файл — один актив, и один код 2FA подтверждает весь пакет.

В файле до четырёх колонок; строка заголовка необязательна, пустые строки пропускаются.

| Колонка | Обязательна | Что это |
|---|---|---|
| `address` | да | Адрес получателя в сети актива |
| `amount` | да | Сумма, которую получит получатель, десятичным числом |
| `payout_id` | нет | Ваш id; дубль в файле или среди прежних выплат — ошибка |
| `comment` | нет | Ваша заметка, например номер счёта |

Каждая строка проверяется заранее: формат адреса, белый список, минимальная сумма, скрининг адреса назначения и дубли `payout_id`. Если хоть одна строка не прошла или баланса не хватает на весь файл, не создаётся ни одной выплаты. Пакет сохраняется как `rejected` с отчётом: номер строки, поле и ошибка.

## Как делать выплаты через API

API CryptoLike создаёт одну выплату на запрос: `POST /v1/withdrawals` с ключом, у которого есть право `withdraw`. Передавайте свой `payout_id`: повтор запроса с тем же активом, суммой и адресом вернёт уже созданную выплату, а другие параметры под тем же id получат отказ `409`. Повторы вашей системы не заплатят дважды. Выплату через API авторизует право `withdraw` у ключа, без кода 2FA, поэтому ограничьте такие ключи IP вашего сервера и включите белый список.

```json
{
  "coin_id": "6f1c2a3e-8d4b-4c5a-9e7f-0a1b2c3d4e5f",
  "amount": "250.00",
  "to_address": "RECIPIENT_ADDRESS",
  "payout_id": "partner-2026-09-017",
  "comment": "September commission"
}
```

Сначала запросите `POST /v1/withdrawals/estimate`: он вернёт комиссию платформы, зарезервированную комиссию сети и `total_debit` — сумму, которая уйдёт с доступного баланса при создании выплаты. У выплаты в USDT комиссия сети показывается и списывается в USDT.

## Какие механизмы защищают выплаты?

Механизмы контроля выплат CryptoLike настраиваются для аккаунта в кабинете, а сами выплаты требуют верифицированного аккаунта (KYB). Статус каждой выплаты приходит вебхуком, виден в кабинете и в Telegram. Если выплата не прошла, отклонена или отменена, вся удержанная сумма возвращается на доступный баланс.

| Механизм | Что делает |
|---|---|
| Белый список адресов | Если включён, принимаются только адреса из списка. Новый адрес становится доступен после задержки (по умолчанию 24 ч); удаление действует сразу. |
| Второе подтверждение | Выплата из кабинета выше вашего порога ждёт в `awaiting_approval`, пока её не подтвердит второй владелец или администратор. Автор не может подтвердить свою выплату. |
| Проверка | Лимиты, необычная активность или комплаенс переводят выплату в `review` — обычно меньше чем на 24 ч. Если за последний час создано больше выплат, чем задано для аккаунта, следующие уходят в `review` — включая строки большого пакета. |
| Скрининг адреса | Адрес назначения, который платформа не принимает, отклоняется с `422 address_refused`. |

Статусы выплаты: `pending` → `processing` → `broadcast` → `completed`. После `failed`, `rejected` или `cancelled` создайте новую выплату, если она всё ещё нужна. Отменить выплату можно до `processing`, а владельцы и администраторы могут подтверждать выплаты в Telegram-боте.

## Как начать

Для массовых выплат в CryptoLike нужны верифицированный аккаунт (KYB), баланс в активе выплаты и — для кабинета — включённая 2FA. Белый список и порог второго подтверждения настройте заранее — до первой крупной выплаты, а не после неё. Первый пакет пошагово разобран в руководстве [массовые выплаты в криптовалюте](https://cryptolike.net/ru/guides/crypto-mass-payouts).

1. Пройдите верификацию аккаунта (KYB) и включите 2FA в кабинете.
2. Загрузите CSV в разделе Выплаты → Пакеты, проверьте предпросмотр строк и итоговую сумму и подтвердите одним кодом 2FA.
3. Или создавайте выплаты из своей системы через SDK: [TypeScript SDK](https://cryptolike.net/ru/integrations/sdk-typescript), [Python SDK](https://cryptolike.net/ru/integrations/sdk-python), [Go SDK](https://cryptolike.net/ru/integrations/sdk-go) или [PHP SDK](https://cryptolike.net/ru/integrations/sdk-php).

Комиссии за выплаты по активам — на [странице тарифов](https://cryptolike.net/ru/pricing). Маршруты, статусы и выгрузка выплат в CSV/XLSX (с фильтром по пакету и `payout_id`) — в [справочнике API](https://cryptolike.net/ru/docs/api).

## Вопросы и ответы

### Сколько выплат можно загрузить одним файлом CSV?

Один файл CSV — до 1 000 строк в одном активе. Каждая строка проверяется до списания: если в одной есть ошибка, ни одна выплата из файла не создаётся, а отчёт покажет номер строки. Большие выплаты разбейте на несколько файлов или создавайте их по одной через API с уникальным `payout_id`.

### Что будет, если в файле ошибка в одной строке?

Не создаётся ни одной выплаты. Пакет сохраняется как `rejected` с отчётом по каждой ошибочной строке: номер строки, поле и ошибка. Исправьте строки и загрузите файл снова.

### Может ли повтор запроса заплатить одному получателю дважды?

Нет. `payout_id` — ключ идемпотентности выплаты. Тот же id с тем же активом, суммой и адресом возвращает существующую выплату, а тот же id с другими параметрами получает отказ.

### Кто платит комиссию сети?

Вы, с баланса, вместе с комиссией платформы. Расчёт показывает обе комиссии и итоговое списание до подтверждения. Режим комиссии для аккаунта задаёт платформа: по умолчанию списывается зарезервированная оценка, в режиме `actual` — фактически уплаченная комиссия, а неиспользованный резерв возвращается на баланс.