#PayIn | Мобильный
POST https://api.nimbo.me/merchant/payin/mobileКаскадный мобильный платёж: оператор подбирается автоматически.
Запрос
{
"amount": "500",
"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": "500",
"currency": "RUB",
"currency_rate": "92.5",
"amount_in_usd": "5.41",
"rate": "92.5",
"commission": "0.16",
"payment_link": "https://pay.nimbo.me/pay/Kx7mN2pQ4rT9wY",
"phone_number": "+79001234567",
"owner_name": "IVAN I.",
"operator_id": "f7b1c8d4-...",
"operator": "MTS",
"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 | ✅ | Номер телефона-получателя. |
operator_id | UUID | ✅ | UUID мобильного оператора. |
operator | string | ✅ | Название оператора (MTS, Tcell, MegaFon…). |
country_name | string | ✅ | Страна оператора. |
payment_currency | string | ✅ | Валюта реквизита. |