Создаёт вывод на криптокошелек через Payout API

Описание

Функциональность выводов подключается по запросу — по умолчанию она недоступна. Для получения доступа обратитесь к вашему менеджеру. После подключения в личном кабинете появится раздел Payout API.

Секретный ключ
Все запросы к Payout API подписываются секретным ключом (SECRET). Крипто-ключ отдельный от ключа карточных выводов — карточным ключом крипто-вывод подписать нельзя. Ключ выдаётся через личный кабинет и хранится только у вас — Platega не имеет к нему доступа после выдачи. Ключ показывается один раз сразу после генерации — немедленно сохраните его. Повторно просмотреть невозможно.

Сброс ключа
Если ключ утерян или скомпрометирован — сбросьте его через раздел Payout API в личном кабинете. Потребуется подтверждение кодом из email. Новый ключ также показывается один раз. Сброс немедленно инвалидирует старый ключ — все запросы, подписанные им, начнут возвращать ошибку аутентификации.

Ограничение по IP
Для ключа можно задать список разрешённых IP-адресов. Если список задан, запросы с других адресов отклоняются с ошибкой аутентификации ещё до проверки подписи. Если список пуст, ограничение не применяется. Настраивается через вашего менеджера.

Подпись запроса (HMAC-SHA256)
Каждый запрос должен быть подписан. Строка для подписи (элементы через \n):

METHOD\nPATH\ntimestamp\nidempotency-key\nsha256_hex(body)

timestamp — unix-время в секундах. Сервер принимает запросы в окне ±300 секунд

idempotency-key — уникальная строка для каждого вывода, генерируется на стороне клиента (например, UUID). Та же строка передаётся в заголовке Idempotency-Key

sha256_hex(body) — SHA-256 от тела запроса, hex строчными буквами. Тело сериализуется без лишних пробелов — те же байты идут и в подпись, и в запрос

Подпись: Base64(HMAC-SHA256(SECRET, string_to_sign))

Заголовок авторизации: Authorization: PG-HMAC kid={MERCHANT_ID}, ts={timestamp}, sig={подпись}

Рассчитанная подпись одноразовая: повторная отправка того же значения в течение 300 секунд отклоняется.

Параметры запроса
Передайте либо walletId сохранённого кошелька, либо walletAddress вместе с currency и network. Сумма amount указывается в USDT и означает сумму получателю: комиссия провайдера списывается сверх неё, при amount 100 и комиссии 3 с баланса уйдёт 103 USDT. Для каждого нового вывода используйте новый Idempotency-Key.

Запрос

POST /api/v1/payouts/crypto

Заголовки

Заголовок	Обязательный	Пример
`Authorization`	да	`PG-HMAC kid=29ef0000-..., ts=1719403200, sig=abc123==`
`Idempotency-Key`	да	`00000000-0000-0000-0000-446655440000`
`Content-Type`	да	`application/json`

Тело

Поле	Тип	Обязательное	Описание
`walletId`	string	нет	ID сохранённого кошелька (альтернатива walletAddress)
`walletAddress`	string	нет	Адрес получателя (альтернатива walletId)
`currency`	string	с walletAddress	Валюта кошелька, всегда `USDT`
`network`	string	с walletAddress	Сеть кошелька: `TRX-TRC20`, `BSC-BEP20`, `ETH-ERC20`, `TON`
`amount`	number	да	Сумма получателю в USDT
`memo`	string	нет	Memo или destination tag, допустим только для TON
`payoutMethod`	string	да	Всегда `CRYPTO`

{
  "walletAddress": "TRX9ynYDLmFyGQZ7ykBrN8xqTFbKvnGSZT",
  "currency": "USDT",
  "network": "TRX-TRC20",
  "amount": 15,
  "payoutMethod": "CRYPTO"
}

Ответ

{
  "withdrawalRecordId": "3c0d321d-40c4-46e3-97f0-7a8f50ce03a6",
  "status": "CREATED",
  "addressMasked": "TRX9...GSZT",
  "currency": "USDT",
  "network": "TRX-TRC20",
  "amountUsdtDebited": 15.15,
  "nativeAmount": 15,
  "providerFee": 0.15
}

Поле	Тип	Описание
`withdrawalRecordId`	string	Идентификатор созданного вывода
`status`	string	Статус вывода. Сразу после создания — `CREATED`
`addressMasked`	string	Маскированный адрес получателя
`currency`	string	Валюта кошелька
`network`	string	Сеть кошелька
`amountUsdtDebited`	number	Сумма, списанная с USDT-баланса мерчанта: вывод плюс комиссия
`nativeAmount`	number	Сумма к отправке получателю в валюте кошелька
`providerFee`	number	Комиссия провайдера в USDT

Создаёт вывод на криптокошелек через Payout API

Описание#

Запрос#

Заголовки#

Тело#

Ответ#

Пример формирования подписи (Python)#

Описание

Запрос

Заголовки

Тело

Ответ

Пример формирования подписи (Python)