CryptoLike делает массовые выплаты в USDT и других активах двумя способами: загрузите в кабинете CSV до 1 000 строк и подтвердите весь файл одним кодом 2FA — или создавайте выплаты через API, по запросу на каждую, со своим payout_id, чтобы повтор не заплатил дважды. Оба способа работают с одним балансом, одними комиссиями, белым списком и правилами подтверждения.
CSV или API: что выбрать
CryptoLike предлагает загрузку CSV финансовой команде, которая платит по таблице, а API — системам, которые платят автоматически: партнёрским программам, маркетплейсам, выводу балансов пользователей. CSV работает по принципу «всё или ничего» — одна ошибочная строка отклоняет файл; через API каждая выплата создаётся отдельно, и каждый ответ обрабатывает ваш код.
| Параметр | CSV в кабинете | API |
|---|---|---|
| Кто пользуется | Владелец, администратор или финансист с 2FA | Ваш сервер с API-ключом с правом withdraw |
| Объём | До 1 000 строк и 1 МБ в файле, один актив на файл | Одна выплата на POST /v1/withdrawals; по умолчанию 600 запросов в минуту на ключ |
| Подтверждение | Один код 2FA на весь файл | Право withdraw у ключа |
| Проверка | Сначала все строки; при любой ошибке ничего не создаётся | Каждая выплата отдельно |
| Повторы | Дубликат payout_id в файле или уже использованный — ошибка строки |
Тот же payout_id возвращает существующую выплату |
| Второе подтверждение | Строки сверх порога ждут другого владельца или администратора | Для API-ключей не применяется |
| Результат | Отчёт по пакету, затем статус каждой выплаты | Ответ, вебхуки withdrawal.*, GET /v1/withdrawals/{id} |
Бизнес-сторона сценария описана на странице массовые выплаты.
Что подготовить
CryptoLike делает выплаты только с верифицированного аккаунта: без верификации (KYB) каждая выплата получает 403 kyb_required. Ещё нужны доступный баланс в активе выплаты, двухфакторная аутентификация у тех, кто создаёт и подтверждает выплаты в кабинете, и для API — ключ с правом withdraw; его выдают владельцы и администраторы, разработчик может его запросить, а владелец или администратор одобряет запрос.
1. Добавьте адреса в белый список
Белый список адресов CryptoLike ограничивает выплаты адресами, которые вы одобрили. В кабинете откройте «Выплаты» → «Белый список» → «Добавить адрес» и подтвердите кодом 2FA. Новый адрес активируется после задержки, заданной для аккаунта (по умолчанию 24 часа), поэтому украденная сессия не перенаправит средства сразу. Удаление адреса действует немедленно.
Когда белый список включён принудительно, кабинет, Telegram-бот и API-ключи принимают только активные адреса из списка; остальные получают 403. Строка упала с ошибкой белого списка? Проверьте актив и время активации этого адреса.
2. Рассчитайте комиссию и проверьте баланс
CryptoLike показывает стоимость до того, как средства сдвинутся: POST /v1/withdrawals/estimate с активом и суммой возвращает комиссию платформы, зарезервированную комиссию сети, total_debit и минимальную сумму. Для токена, например USDT, комиссия сети пересчитывается в актив выплаты, поэтому все цифры — в одной единице. Для CSV делается один расчёт на файл.
total_debit = сумма + комиссия платформы + резерв комиссии сети; при создании выплаты он переходит из available в hold. Тарифы — на странице тарифов. Расчёт недоступен? Выплата не создаётся — повторите позже.
3. Подготовьте CSV-файл
CryptoLike читает CSV с колонками address,amount[,payout_id[,comment]]: адрес и сумма обязательны, ваш ID выплаты и комментарий — по желанию. Строка заголовка с address пропускается, пустые строки игнорируются, в одном файле — до 1 000 строк одного актива. Суммы — десятичные числа, знаков после точки не больше, чем у актива.
address,amount,payout_id,comment
TXYZ...1,125.50,aff-2026-09-001,Комиссия за сентябрь
TXYZ...2,80,aff-2026-09-002,Комиссия за сентябрьДайте каждой строке payout_id: он связывает выплату с вашим учётом и не даёт создать её дважды. Строк больше 1 000? Разделите файл.
4. Загрузите файл и подтвердите одним кодом
CryptoLike проверяет каждую строку до создания выплат: формат адреса, белый список, минимум, проверку адреса назначения и повторы payout_id. В кабинете откройте «Выплаты» → «Загрузить CSV», выберите актив, перетащите файл, проверьте предпросмотр с числом строк и итогом и введите один код 2FA на весь пакет.
Корректный файл создаёт все выплаты одной транзакцией. Любая ошибочная строка отклоняет весь файл — ничего не создаётся, а в отчёте указаны строка, поле и ошибка. То же происходит, если баланс не покрывает файл. Исправьте строки и загрузите снова; отклонённый пакет остаётся на вкладке «Пакеты».
5. Или отправляйте выплаты через API
API CryptoLike создаёт одну выплату на POST /v1/withdrawals с coin_id, amount, to_address и вашим payout_id. Повтор запроса с тем же активом, суммой и адресом вернёт существующую выплату, а не заплатит второй раз; тот же payout_id с другими параметрами получит 409. Для точных повторов добавьте ключ идемпотентности.
const payout = await api.withdrawals.create(
{ coin_id: usdtTrc20Id, amount: "125.50", to_address: "T...", payout_id: "aff-2026-09-001" },
"aff-2026-09-001",
);Отправляйте выплаты равномерно: лимит по умолчанию — 600 запросов в минуту на ключ, а ответ 429 сообщает в Retry-After, сколько ждать. Полный справочник — документация API.
6. Подтвердите крупные выплаты и следите за проверкой
CryptoLike задерживает выплаты, которым нужен человек. Выплата из кабинета или Telegram-бота, включая строки CSV, сверх порога второго подтверждения ждёт в awaiting_approval, пока её не одобрит другой владелец или администратор; автор этого сделать не может. Лимиты и необычные паттерны отправляют выплату в review; обычно проверка завершается в течение 24 часов.
Подтверждайте в кабинете («Выплаты» → «Подтверждения») или в Telegram-боте с кодом 2FA. Порог задаётся для каждого актива и не применяется к API-ключам: право withdraw у ключа — уже решение владельца.
7. Отслеживайте каждую выплату до конца
CryptoLike сообщает о каждой выплате статусом в кабинете и в API и подписанным вебхуком: событий withdrawal.processing, withdrawal.completed, withdrawal.failed и withdrawal.rejected достаточно, чтобы довести её до конца. completed значит, что транзакция подтверждена и комиссии списаны; при failed, rejected и cancelled весь резерв возвращается на доступный баланс.
| Статус | Что значит | Что делать |
|---|---|---|
pending |
Средства в резерве, выплата в очереди | При необходимости отменить |
review |
Ручная проверка, обычно меньше 24 ч | Ждать или отменить |
awaiting_approval |
Ждёт второго владельца или администратора | Подтвердить с другого аккаунта |
processing |
Подписывается и отправляется; отменить нельзя | Ждать |
broadcast |
В сети, txid известен |
Ждать подтверждений |
completed |
Подтверждена, комиссии списаны | Ничего |
failed |
Сеть отклонила транзакцию; средства возвращены | Создать новую выплату |
rejected |
Отклонена на проверке; средства возвращены | Проверить адрес или написать в поддержку |
cancelled |
Вы отменили; средства возвращены | Ничего |
GET /v1/withdrawals фильтрует по batch_id или payout_id и выгружает CSV или XLSX для сверки.
Ошибки и что делать
CryptoLike возвращает ошибки выплат в одном формате: HTTP-статус, code и details; отклонённый CSV вместо этого приходит как пакет с error_rows. У каждого случая есть действие для восстановления, а отклонённая выплата никогда не оставляет средства в резерве. Полный список — в справочнике API.
| HTTP · code | Что произошло | Что делать |
|---|---|---|
403 kyb_required |
Аккаунт не верифицирован | Пройдите верификацию аккаунта в кабинете |
403 forbidden |
Белый список включён, а адрес в нём не активен | Добавьте адрес и дождитесь активации или отключите принудительный режим |
403 auth.permission_denied |
У ключа нет права withdraw |
Используйте ключ с withdraw |
409 conflict, insufficient_funds |
available не покрывает total_debit |
Пополните баланс или уменьшите выплату |
409 conflict по известному payout_id |
Тот же ID, но другой актив, сумма или адрес | Возьмите новый payout_id или прочитайте существующую выплату |
422 address_refused |
Платформа не принимает этот адрес назначения | Используйте другой адрес |
413 payload_too_large |
Файл больше 1 МиБ | Разделите файл |
429 rate_limited |
Превышен лимит ключа | Подождите Retry-After секунд |
503 unavailable |
Расчёт комиссии или актив временно недоступны | Повторите с паузой; ничего не создано |
Вопросы и ответы
Сколько выплат помещается в один CSV-файл?
До 1 000 строк одного актива, с одним кодом 2FA на весь файл. Для списка длиннее CryptoLike примет несколько файлов, или создавайте выплаты через API.
Что будет, если одна строка в CSV с ошибкой?
Ничего не создаётся. CryptoLike сохраняет пакет как отклонённый с отчётом по каждой ошибочной строке — номер, поле и ошибка, — вы исправляете эти строки и загружаете файл снова. Средства под отклонённый файл не резервируются.
Может ли повтор заплатить одному получателю дважды?
Нет, если вы передаёте payout_id. Повторный запрос API с тем же payout_id, активом, суммой и адресом возвращает уже созданную выплату, а строка CSV с использованным ранее payout_id отклоняется как дубликат.
Можно ли отменить выплату?
Да, пока она в статусе pending, review или awaiting_approval: отмените её в кабинете или через POST /v1/withdrawals/{id}/cancel, и резерв вернётся на доступный баланс. Начиная с processing выплата подписывается и отправляется, отменить её уже нельзя.