Методы оплаты
GET /methods возвращает способы оплаты, доступные вашему проекту прямо сейчас, с действующей комиссией и лимитами суммы. Используйте его, чтобы показывать покупателю только рабочие способы и заранее проверять сумму.
API v1 · обновлено 2026-09-12
GET /methods
| Поле | Описание |
|---|---|
code | Код метода для поля method при создании счёта: sbp, card или crypto (USDT в сетях TRC20 и BEP20, см. ниже). |
title | Название для показа покупателю (русский). |
feePct | Ваша комиссия по этому методу в процентах, с учётом персональных условий, если они назначены. |
min, max, currency | Допустимый диапазон суммы счёта для метода и валюта (RUB). |
enabled | true — можно создавать счета с этим методом прямо сейчас. false — метод известен проекту, но временно недоступен (технические работы); счёт с ним вернёт 422 method_unavailable. |
Доступность методов
Список динамический: при технических работах на стороне банков метод остаётся в ответе с enabled: false, а отключённые для вашего проекта методы не показываются вовсе. Если при создании счёта method не передан, покупатель увидит на странице оплаты все включённые методы и выберет сам.
Текущий статус методов также публикуется на странице Статус системы.
СБП
Оплата через Систему быстрых платежей: на десктопе покупатель сканирует QR-код приложением банка, на телефоне — нажимает кнопку и подтверждает платёж в банке. Подтверждение обычно приходит за 5–15 секунд. Самая низкая комиссия.
Банковские карты
Карты российских банков (МИР, Visa, Mastercard) на защищённой странице оплаты Payra. Данные карты не проходят через ваш сервер — сертификация PCI DSS вам не нужна.
USDT (TRC20 / BEP20)
Оплата стейблкоином USDT в сети Tron (TRC20) или BNB Smart Chain (BEP20) — для покупателей за пределами России или тех, кто держит средства в крипте. Счёт создаётся в рублях, как обычно (method: "crypto" или выбор на странице оплаты), а сумма в USDT считается по курсу на момент выбора сети. Наша комиссия за метод — отдельная ставка, как у СБП и карт (см. тарифы и раздел «Основное» проекта); комиссию сети (≈ $2 в Tron, ≈ $0,05 в BSC) платит отправитель.
Как это работает
- Покупатель выбирает «Оплатить USDT» и сеть. Страница показывает наш адрес (текстом и QR-кодом) и точную сумму в USDT — например
49.8713. - Сумма уникальна: к сумме по курсу добавляется «хвост» в третьем-четвёртом знаке после запятой, который в этот момент не ждёт ни один другой платёж в той же сети. Именно по сумме мы узнаём, чей это перевод — ни мемо, ни комментарии, ни отдельные адреса не нужны. Поэтому сумму нужно перевести ровно, до последнего знака.
- На перевод даётся 30 минут (таймер на странице). Перевод виден обычно через 15–60 секунд после отправки — статус меняется на «Обнаружен» с числом подтверждений.
- Счёт считается оплаченным после подтверждения сетью: 15 блоков в BNB Smart Chain или 20 блоков в Tron — обычно меньше минуты. В этот момент уходит вебхук
invoice.paid, деньги зачисляются на баланс в рублях по зафиксированному курсу.
Что важно знать
- Перевод, отправленный после истечения 30 минут, всё равно зачитывается автоматически, когда попадает в сеть — счёт из «Истёк» переходит в «Оплачен» и вебхук приходит как обычно.
- Если сумма не совпала (недоплата или переплата в пределах 2 %), платёж не зачисляется автоматически: его разбирает наша поддержка вместе с покупателем — в течение рабочего дня счёт либо проводится как оплаченный, либо средства возвращаются отправителю.
- Другие монеты (TRX, BNB, USDC) и другие сети (Ethereum, Polygon, Solana) не принимаются — такой перевод теряется, об этом на странице оплаты стоят предупреждения.
- Возвраты по USDT-платежам делаются в рублях на баланс мерчанта так же, как по остальным методам (возвраты); возврат в крипте покупателю — по договорённости через поддержку.
- Минимальная сумма счёта для метода — 100 ₽ (иначе комиссия сети превысит платёж). Тестовые ключи: метод доступен в эмуляторе, как СБП и карты.
Кэширование
Комиссии и лимиты меняются редко; можно кэшировать ответ на 5–10 минут. Но перед показом способа покупателю в момент оплаты лучше запросить актуальный список.