Криптовалюта
Выплата криптовалютой на кошелёк получателя — в криптовалюте или в фиате с пересчётом
Перед тем как начать
Авторизация
Как подписывать запросы API-токеном.
Обзор выплат
Общий формат запроса, поля ответа и статусы.
Это направление выплат доступно не всем мерчантам. Уточните доступность у вашего менеджера и убедитесь, что на вашем балансе мерчанта достаточно средств, прежде чем создавать выплату.
Обзор
| Валюта выплаты | Что получает получатель | Тип платежа |
|---|---|---|
USDT, USDC, BTC, ETH, LTC, TRX, TON, SOL, BNB, DOGE, XMR, MATIC | Ровно сумму выплаты в этой криптовалюте | CRYPTO |
RUB, USD | Эквивалент суммы в токене по курсу провайдера на момент выплаты | CRYPTO |
Токен и сеть (например, USDT в сети TRC-20) задаёт терминал вашего сервиса выплат, а не запрос. Какие токены и сети подключены, уточните у менеджера. Для разных сетей одного токена используйте разные сервисы (serviceId).
Сумма в криптовалюте — до 8 знаков после запятой (USDT, USDC и фиат — до 2). Запрос с большим числом знаков отклоняется с 400.
Поля account
| Поле | Тип | Обязательное | Описание |
|---|---|---|---|
name | string | ✅ Да | Имя получателя |
requisites | string | ✅ Да | Реквизиты получателя: номер карты, номер телефона, PIX-ключ и т. д. в зависимости от paymentType |
userId | string | ✅ Да | ID пользователя в вашей системе |
requisites — адрес кошелька получателя в сети токена, без пробелов. В name можно передать имя получателя или любую строку.
| Поле | Тип | Обязательное | Описание |
|---|---|---|---|
destTag | string | ❌ Нет | Destination tag / memo кошелька. Обязателен для сетей и бирж, которые его требуют: без него средства теряются |
Проверьте адрес и сеть перед отправкой: перевод в блокчейне необратим. Выплата на адрес другой сети не возвращается.
Пример запроса
Выплата в криптовалюте:
curl -X POST "https://api.panel.valutix.kz/v1/payouts" \
-H "Content-Type: application/json" \
-H "X-Api-Token: YOUR_API_TOKEN" \
-d '{
"amount": 150.5,
"currency": "USDT",
"paymentType": "CRYPTO",
"serviceId": 7,
"externalId": "payout-123",
"account": {
"name": "Client",
"requisites": "TSt8vjaid4b5UumFJ...",
"userId": "user_12345"
}
}'Выплата в фиате — получатель получит эквивалент 10000 RUB в токене терминала:
curl -X POST "https://api.panel.valutix.kz/v1/payouts" \
-H "Content-Type: application/json" \
-H "X-Api-Token: YOUR_API_TOKEN" \
-d '{
"amount": 10000,
"currency": "RUB",
"paymentType": "CRYPTO",
"serviceId": 8,
"externalId": "payout-124",
"account": {
"name": "Client",
"requisites": "rDsbeomae4FXwgQTJp9Rs64Qg9vDiTCdBv",
"destTag": "12345678",
"userId": "user_12345"
}
}'Ответ
В ответе возвращается стандартный объект выплаты со статусом CREATED. Сохраните id, чтобы отслеживать выплату.
Поля объекта выплаты
Выплата переходит в COMPLETED, когда перевод подтверждён в сети, и в FAILED, если провайдер его отклонил. Если провайдер не подтвердил создание перевода из-за сбоя связи, выплата остаётся в PROCESSING до ручной проверки: так исключается повторная отправка средств.