#PayIn | Счёт

#POST /merchant/payin/account

POST https://api.nimbo.me/merchant/payin/account

Платёж на расчётный счёт (для B2B-операций).

Только локально: реквизит подбирается из пула в стране валюты. Кросс-бордер-варианта у метода нет, country_code и bank_id не используются.

Запрос

{
  "amount": "5000",
  "currency": "RUB",
  "merchant_transaction_id": "ord_001"
}
ПолеТипОбяз.Описание
amountstring✅Сумма платежа в указанной currency. До 8 знаков после точки.
currencystring✅Код 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_idstring✅UNIQUE ID транзакции на стороне мерчанта. Повтор → 400 DUPLICATE_ORDER.
client_idstring-Только для интеграций по use_counterparty (КА). Тарифицируется отдельно.
webhook_urlstring-Per-tx URL для callback. Перебивает дефолт из dashboard.

Ответ

{
  "id": "Kx7mN2pQ4rT9wY",
  "merchant_transaction_id": "ord_001",
  "expires_at": "2026-05-04T11:23:45+00:00",
  "amount": "5000",
  "currency": "RUB",
  "currency_rate": "92.5",
  "amount_in_usd": "54.05",
  "rate": "92.5",
  "commission": "1.62",
  "payment_link": "https://pay.nimbo.me/pay/Kx7mN2pQ4rT9wY",
  "account_number": "40817810099000000000",
  "owner_name": "IVAN IVANOV",
  "bank_id": "...",
  "bank_name": "Тинькофф",
  "country_name": "РФ",
  "payment_currency": "RUB"
}
ПолеТипОбяз.Описание
idstring✅Внутренний ID транзакции. Используйте для GET /merchant/<id>/status.
merchant_transaction_idstring✅Эхо вашего merchant_transaction_id из запроса.
expires_atstring✅UTC ISO 8601 - после этого реквизит сгорает, оплата невозможна.
amountstring✅Эхо суммы запроса.
currencystring✅Эхо валюты запроса.
currency_ratestring✅Курс currency → USD на момент создания.
amount_in_usdstring✅Сумма в USD (для статистики и сверки).
ratestring✅Курс реквизита для расчёта комиссии.
commissionstring✅Комиссия за транзакцию в USD.
payment_linkstring✅Публичная ссылка для клиента - открывает страницу оплаты.
account_numberstring✅Номер расчётного счёта-получателя.
owner_namestring✅ФИО владельца счёта.
bank_idUUID✅UUID банка-получателя.
bank_namestring✅Название банка-получателя.
country_namestring✅Страна банка-получателя.
payment_currencystring✅Валюта реквизита.