Создаёт вывод на рублёвую карту через 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 секунд отклоняется.

Параметры запроса
Передайте либо cardId сохранённой карты, либо cardNumber полного PAN. Допустимая сумма одного вывода: от 1000 до 87500 RUB. Для каждого нового вывода используйте новый Idempotency-Key.

Запрос

POST /api/v1/payouts/card-rub

Заголовки

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

Тело

Поле	Тип	Обязательное	Описание
`cardId`	string	нет	ID сохранённой карты (альтернатива cardNumber)
`cardNumber`	string	нет	Номер карты получателя (16 цифр)
`label`	string	нет	Название карты. Применяется, когда карта передана номером и сохраняется в кабинете
`amountRub`	integer	да	Сумма вывода в рублях
`payoutMethod`	string	да	Всегда `CARD`
`currencyRequested`	string	да	Всегда `RUB`

{
  "cardNumber": "2200000000000000",
  "amountRub": 1500,
  "payoutMethod": "CARD",
  "currencyRequested": "RUB"
}

Ответ

{
  "withdrawalRecordId": "3c0d321d-40c4-46e3-97f0-7a8f50ce03a6",
  "status": "CREATED",
  "cardMasked": "**** 0000",
  "amountUsdtDebited": 13.270341
}

Поле	Тип	Описание
`withdrawalRecordId`	string	Идентификатор созданного вывода
`status`	string	Статус вывода. Сразу после создания — `CREATED`
`cardMasked`	string	Маскированный номер карты
`amountUsdtDebited`	number	Сумма, списанная с USDT-баланса мерчанта: сумма вывода и комиссия, пересчитанные по курсу

Создаёт вывод на рублёвую карту через Payout API

Описание#

Запрос#

Заголовки#

Тело#

Ответ#

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

Описание

Запрос

Заголовки

Тело

Ответ

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