#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`, `BYN`, `KZT`, `UZS`, `KGS`, `TJS`, `TMT`, `AMD`, `AZN`, `GEL`, `MDL`, `UAH`, `KRW`, `CNY`, `HKD`, `TWD`, `MOP`, `JPY`, `MNT`, `THB`, `VND`, `IDR`, `MYR`, `SGD`, `PHP`, `KHR`, `LAK`, `MMK`, `BND`, `INR`, `PKR`, `BDT`, `LKR`, `NPR`, `MVR`, `AFN`, `TRY`, `AED`, `SAR`, `QAR`, `KWD`, `BHD`, `OMR`, `JOD`, `ILS`, `LBP`, `IQD`, `YER`, `ARS`, `BRL`, `CLP`, `COP`, `PEN`, `MXN`, `UYU`, `PYG`, `BOB`, `VES`, `DOP`, `USD`, `EUR`, `GBP`.
`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.