#PayIn | СБП

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

Каскадный режим SBP: реквизит подбирается автоматически из доступного пула в стране валюты.

Запрос

{
  "amount": "5000",
  "currency": "RUB",
  "merchant_transaction_id": "ord_001"
}

Поле	Тип	Обяз.	Описание
`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`.
`client_id`	`string`	—	Только для интеграций по `use_counterparty` (КА). Тарифицируется отдельно.
`webhook_url`	`string`	—	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",
  "phone_number": "+79001234567",
  "owner_name": "IVAN IVANOV",
  "bank_id": "8c8a3a9e-...",
  "bank_name": "Сбербанк",
  "country_name": "РФ",
  "payment_currency": "RUB"
}

Поле	Тип	Обяз.	Описание
`id`	`string`	✅	Внутренний ID транзакции. Используйте для `GET /merchant/<id>/status`.
`merchant_transaction_id`	`string`	✅	Эхо вашего `merchant_transaction_id` из запроса.
`expires_at`	`string`	✅	UTC ISO 8601 — после этого реквизит сгорает, оплата невозможна.
`amount`	`string`	✅	Эхо суммы запроса.
`currency`	`string`	✅	Эхо валюты запроса.
`currency_rate`	`string`	✅	Курс `currency` → USD на момент создания.
`amount_in_usd`	`string`	✅	Сумма в USD (для статистики и сверки).
`rate`	`string`	✅	Курс реквизита для расчёта комиссии.
`commission`	`string`	✅	Комиссия за транзакцию в USD.
`payment_link`	`string`	✅	Публичная ссылка для клиента — открывает страницу оплаты.
`phone_number`	`string`	✅	Номер телефона-получателя в формате `+<country>...`.
`owner_name`	`string`	✅	ФИО владельца счёта.
`bank_id`	`UUID`	✅	UUID банка-получателя.
`bank_name`	`string`	✅	Название банка-получателя.
`country_name`	`string`	✅	Страна банка-получателя.
`payment_currency`	`string`	✅	Валюта реквизита.