Пополнение мобильного¶

Плательщик пополняет баланс мобильного телефона получателя: реквизит — номер телефона, банк реквизита — оператор связи. Заявка устроена так же, как приём по СБП: тот же метод API, те же статусы, callback-и и правила повторов. Отличаются payment_method и то, как платит плательщик.

	СБП	Пополнение мобильного
`payment_method`	`sbp`	`mobile_topup`
Что получает плательщик	номер телефона в `requisite`	номер телефона в `requisite`
`requisite_bank`	банк получателя	оператор связи, например `МТС`, `Билайн`, `Мегафон`
Как платит плательщик	«Перевод по СБП» по номеру телефона	пополняет баланс этого номера (оплата мобильной связи)

Создать заявку¶

POST /api/v1/payments с payment_method: "mobile_topup". Запрос подписывается так же, как для СБП, остальные поля — как у СБП, см. Приём по СБП → Поля запроса. Перевода внутри банка (is_intrabank) у метода нет. Метод должен быть в договоре вашего проекта.

{
  "merchant_payment_id": "order-1006",
  "amount": "1500.00",
  "payment_method": "mobile_topup"
}

Ответ¶

{
  "id": "7d2a4c1e-5f6b-4a8c-9e0d-2b3c4d5e6f70",
  "merchant_payment_id": "order-1006",
  "status": "processing",
  "amount": 1500,
  "initial_amount": 1500,
  "currency": "RUB",
  "geo_code": "RU",
  "payment_method": "mobile_topup",
  "requisite": "+79991234567",
  "requisite_bank": "МТС",
  "holder_name": null,
  "created_at": "2026-10-23T09:30:00Z",
  "updated_at": "2026-10-23T09:30:01Z"
}

requisite — номер телефона, который нужно пополнить;
requisite_bank — оператор связи этого номера.

Остальные поля ответа и расчёт merchant_information — как у СБП: Ответ и Расчёт merchant_information.

Что показать плательщику¶

Номер телефона — requisite с кнопкой «Скопировать».
Оператор — requisite_bank: плательщик выбирает его в разделе оплаты мобильной связи.
Сумма — ровно amount, одним платежом.
Срок — обратный отсчёт от created_at на срок заявки вашего проекта (по умолчанию 15 минут).

Номер — только для этой заявки

Не сохраняйте номер и не показывайте его повторно. Для новой оплаты создайте новую заявку.

Статусы и результат¶

Статусы, callback-и и опрос — такие же, как у СБП: Статусы и Как узнать результат.