#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`, `KRW`, `KZT`, `UZS`, `TJS`, `KGS`, `AMD`, `AZN`, `BYN`, `GEL`.
`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` и т.д.