Сценарии
Массовые выплаты в криптовалюте партнёрам и подрядчикам
Выплаты партнёрам и подрядчикам в USDT и других активах — файлом CSV до 1 000 строк или через API с вашим payout_id. Проверка до списания, одно 2FA, без дублей.
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 вашего сервера и включите белый список.
{
"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. Белый список и порог второго подтверждения настройте заранее — до первой крупной выплаты, а не после неё. Первый пакет пошагово разобран в руководстве массовые выплаты в криптовалюте.
- Пройдите верификацию аккаунта (KYB) и включите 2FA в кабинете.
- Загрузите CSV в разделе Выплаты → Пакеты, проверьте предпросмотр строк и итоговую сумму и подтвердите одним кодом 2FA.
- Или создавайте выплаты из своей системы через SDK: TypeScript SDK, Python SDK, Go SDK или PHP SDK.
Комиссии за выплаты по активам — на странице тарифов. Маршруты, статусы и выгрузка выплат в CSV/XLSX (с фильтром по пакету и payout_id) — в справочнике API.
Вопросы и ответы
Сколько выплат можно загрузить одним файлом CSV?
Один файл CSV — до 1 000 строк в одном активе. Каждая строка проверяется до списания: если в одной есть ошибка, ни одна выплата из файла не создаётся, а отчёт покажет номер строки. Большие выплаты разбейте на несколько файлов или создавайте их по одной через API с уникальным payout_id.
Что будет, если в файле ошибка в одной строке?
Не создаётся ни одной выплаты. Пакет сохраняется как rejected с отчётом по каждой ошибочной строке: номер строки, поле и ошибка. Исправьте строки и загрузите файл снова.
Может ли повтор запроса заплатить одному получателю дважды?
Нет. payout_id — ключ идемпотентности выплаты. Тот же id с тем же активом, суммой и адресом возвращает существующую выплату, а тот же id с другими параметрами получает отказ.
Кто платит комиссию сети?
Вы, с баланса, вместе с комиссией платформы. Расчёт показывает обе комиссии и итоговое списание до подтверждения. Режим комиссии для аккаунта задаёт платформа: по умолчанию списывается зарезервированная оценка, в режиме actual — фактически уплаченная комиссия, а неиспользованный резерв возвращается на баланс.
Как подключить
Гайды и статьи
- Массовые выплаты в USDT: CSV до 1 000 строк или APIМассовые выплаты в USDT и другой криптовалюте через CryptoLike: CSV до 1 000 строк с одним кодом 2FA или API с payout_id. Белый список, подтверждения, ошибки.
- Из чего состоит комиссия за криптоплатёжСколько стоит криптоплатёж в CryptoLike: 0,8 % за подтверждённый платёж с минимумом для актива, выплаты по сетевой комиссии без наценки — с примерами расчёта.
- Защита криптовыплат: белый список адресов и второе подтверждениеПошаговая настройка защиты выплат в CryptoLike: 2FA, белый список адресов с задержкой 24 часа, второе подтверждение выше порога, ограниченные API-ключи.
- Криптоплатежи в учёте: выписки, фиатная оценка и выгрузкиКакие данные CryptoLike даёт бухгалтерии: выписка, которая всегда сходится, фиатная оценка на момент каждого движения, выгрузки CSV и XLSX и регулярные дайджесты.
Термины на странице
Начните с тестового платежа
Создайте аккаунт, попросите у поддержки доступ к тестовой среде и посмотрите, как платёж проходит путь от pending до paid в тестовой сети.