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

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

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

## Создать заявку { #create }

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

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

## Ответ { #response }

```json
{
  "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` — как у СБП:
[Ответ](sbp.md#response) и [Расчёт `merchant_information`](sbp.md#merchant-information).

## Что показать плательщику { #payer-screen }

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

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

## Статусы и результат { #result }

Статусы, callback-и и опрос — такие же, как у СБП:
[Статусы](sbp.md#statuses) и [Как узнать результат](sbp.md#result).