#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, 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. |
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 | ✅ | Валюта реквизита. |