#PayOut | Карта

#POST /merchant/payout/card

POST https://api.nimbo.me/merchant/payout/card

Выплата на карту получателя. Реквизиты (card_number, owner_name, bank_id) присылает мерчант — поэтому ответ их не возвращает.

Запрос

{
  "amount": "5000",
  "currency": "RUB",
  "merchant_transaction_id": "payout_001",
  "card_number": "2200000000000000",
  "owner_name": "IVAN IVANOV",
  "bank_id": "8c8a3a9e-8d3a-4d80-9e40-3a0f8a9b3c00"
}

Поле	Тип	Обяз.	Описание
`amount`	`string`	✅	Сумма платежа в указанной `currency`. До 8 знаков после точки.
`currency`	`string`	✅	ISO-4217: `RUB`, `KRW`, `KZT`, `UZS`, `TJS`, `KGS`, `AMD`, `AZN`, `BYN`, `GEL`.
`merchant_transaction_id`	`string`	✅	UNIQUE ID транзакции на стороне мерчанта. Повтор → `400 DUPLICATE_ORDER`.
`card_number`	`string`	✅	Номер карты получателя (16 цифр, без пробелов и тире).
`owner_name`	`string`	✅	ФИО получателя.
`bank_id`	`UUID`	✅	UUID банка-получателя из `GET /merchant/banks`.
`client_id`	`string`	—	Только для интеграций по `use_counterparty` (КА). Тарифицируется отдельно.
`webhook_url`	`string`	—	Per-tx URL для callback. Перебивает дефолт из dashboard.

Ответ

{
  "id": "Kx7mN2pQ4rT9wY",
  "merchant_transaction_id": "payout_001",
  "expires_at": null,
  "amount": "5000",
  "currency": "RUB",
  "currency_rate": "92.5",
  "amount_in_usd": "54.05",
  "rate": "92.5",
  "commission": "1.62"
}

Поле	Тип	Обяз.	Описание
`id`	`string`	✅	Внутренний ID транзакции выплаты.
`merchant_transaction_id`	`string`	✅	Эхо вашего `merchant_transaction_id`.
`expires_at`	`string`	✅	Всегда `null` для PayOut.
`amount`	`string`	✅	Эхо суммы.
`currency`	`string`	✅	Эхо валюты.
`currency_rate`	`string`	✅	Курс `currency` → USD.
`amount_in_usd`	`string`	✅	Сумма в USD.
`rate`	`string`	✅	Курс реквизита для расчёта комиссии.
`commission`	`string`	✅	Комиссия в USD.