#База

ПараметрЗначение
URLhttps://api.nimbo.me
AuthAuthorization: Bearer <merchant_token>
Contentapplication/json
TimeUTC ISO 8601
Moneystring, до 8 знаков после точки
CurrenciesRUB, 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

#Получение реквизитов и тайминг

Реквизиты выдаются в течение 4-5 секунд после POST. Если за это время свободного реквизита в пуле не нашлось - мы возвращаем 200 OK с телом транзакции, но без реквизитных полей и без payment_link (bank_id, bank_name, owner_name, card_number / phone_number / account_number / payment_url).

#Как выглядит ответ без реквизитов

{
  "id": "W5ENYLCT",
  "merchant_transaction_id": "069edbda-583d-70f0-8000-68c886cc7f25",
  "amount": "5000",
  "currency": "RUB",
  "currency_rate": "92.5",
  "amount_in_usd": "54.05",
  "rate": "2.5",
  "commission": "1.35",
  "expires_at": "2026-05-21T10:00:00.000Z"
}

Ровно 9 полей. Универсальный shape для всех методов (card / sbp / qr / mobile / account / acquiring и т.д.). payment_link не возвращается - платить нечем, реквизит не назначен. Транзакция протухнет по expires_at со статусом expired.

#Что с этим делать

  • Ставьте таймаут запроса 5-7 секунд.
  • Если в ответе нет реквизитных полей - реквизит уже не догрузится. Дальше ждать нечего.
  • Транзакция создана, но клиент по ней заплатить не сможет - она протухнет по expires_at со статусом expired.
  • Для повторной попытки создавайте новую транзакцию с новым merchant_transaction_id (старый занят, повтор → 400 DUPLICATE_ORDER).
Дальше
Поля запроса