К содержимому

Сценарии

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

Выплаты партнёрам и подрядчикам в 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 вашего сервера и включите белый список.

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. Белый список и порог второго подтверждения настройте заранее — до первой крупной выплаты, а не после неё. Первый пакет пошагово разобран в руководстве массовые выплаты в криптовалюте.

  1. Пройдите верификацию аккаунта (KYB) и включите 2FA в кабинете.
  2. Загрузите CSV в разделе Выплаты → Пакеты, проверьте предпросмотр строк и итоговую сумму и подтвердите одним кодом 2FA.
  3. Или создавайте выплаты из своей системы через 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 — фактически уплаченная комиссия, а неиспользованный резерв возвращается на баланс.

Как подключить

В документации →

Гайды и статьи

Термины на странице

Начните с тестового платежа

Создайте аккаунт, попросите у поддержки доступ к тестовой среде и посмотрите, как платёж проходит путь от pending до paid в тестовой сети.