#PayIn | Эквайринг

#POST /merchant/payin/acquiring

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

Банковский эквайринг (HPP - Hosted Payment Page). Клиент попадает на checkout-страницу банка-эквайера (Tinkoff / Сбер / Cloudpayments и т.д.), оплачивает картой, возвращается на return_url.

Запрос

{
  "amount": "5000",
  "currency": "RUB",
  "merchant_transaction_id": "ord_001",
  "return_url": "https://merchant.example/done"
}

Поле	Тип	Обяз.	Описание
`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`.
`return_url`	`string`	✅	URL, куда вернётся клиент после оплаты (success/fail/cancel определяется query-параметрами).
`client_id`	`string`	-	Только для интеграций по `use_counterparty` (КА). Тарифицируется отдельно.
`webhook_url`	`string`	-	Per-tx URL для callback. Перебивает дефолт из dashboard.

Ответ

{
  "id": "Kx7mN2pQ4rT9wY",
  "merchant_transaction_id": "ord_001",
  "expires_at": "2026-05-21T10:00:00.000Z",
  "amount": "5000",
  "currency": "RUB",
  "currency_rate": "92.5",
  "amount_in_usd": "54.05",
  "rate": "2.5",
  "commission": "1.35",
  "payment_url": "https://checkout.tinkoff.ru/Kx7mN2pQ4rT9wY",
  "acquirer": "tinkoff"
}

Поле	Тип	Обяз.	Описание
`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_url`	`string`	✅	HPP URL банка-эквайера для редиректа клиента (checkout-страница).
`acquirer`	`string`	✅	Код банка-эквайера: `tinkoff`, `sber`, `cloudpayments`, `alfa` и т.д.