Лимиты, чеки и сверки
Вопросы, которые упираются не в API, а в договор, эквайера или бухгалтерию: сколько можно проводить, кто выбивает чек, откуда брать данные для сверки и как ограничить доступ по сети.
Какие действуют лимиты?
Лимиты на суммы разовых операций и на суточные обороты устанавливает банк-эквайер или оператор связи — не платформа. Для проекта их можно изменить по запросу через персонального менеджера.
Порядок величин, от которого стоит отталкиваться при проектировании:
| Ограничение | Типовое значение |
|---|---|
| Разовая операция | до 100 000 ₽ |
| Операции по карте в сутки | до 100 000 ₽ |
| Суточный оборот | до 500 000 ₽ |
Значения в таблице — ориентир, а не гарантия: фактические лимиты зависят от эквайера, оператора и договора. Если рассчитываете на суммы того же порядка, сверьтесь с менеджером до запуска.
Превышение приходит обычным отказом платежа. Прогнать этот исход, не упираясь в реальный лимит, можно в песочнице — среди тестовых карт есть та, что даёт LimitExceeded, см. Быстрый старт.
Кто выбивает фискальный чек?
Зависит от того, подключён ли кассовый модуль I-Free.
Кассы I-Free. Чек уходит автоматически через кассы и ОФД. От вас нужно одно — передавать в запросе корректный email покупателя: на него отправляется чек. В API поле необязательное, но без него чек доставлять некуда.
Своя касса. Если касса у вас собственная, фискализация целиком на вашей стороне: дождитесь уведомления об успешном платеже и пробейте чек сами.
Ссылка на чек, сформированный кассами I-Free, приходит отдельным уведомлением SendPaymentReceipt — блок PaymentReceiptInfo с единственным полем ReceiptUrl, см. Вебхуки.
Что лежит в отчёте сверки?
Отчёт выгружается из личного кабинета в формате .xlsx. Колонки:
InvoiceId · MerchantOrderId · DateCreate · DateProcessed · ServiceNumber · Subscriber · EupCurrency · Eup · EupWithVat · Operator · PartnerProfit · PartnerProfitWithVat · InvoiceStatus · RefundStatus
Часть колонок повторяет значения, которые вы уже видели в API: MerchantOrderId — идентификатор заказа, переданный при создании счёта, по нему отчёт и сводится с вашими данными; InvoiceId, InvoiceStatus и PartnerProfit совпадают с одноимёнными полями ответа GET /invoices/{invoice_id} и уведомления об оплате.
Внесистемные банковские возвраты и чарджбэки через API не проходят. Их фиксирует банк, в вызовах и вебхуках они не появляются — увидеть их можно только в актах сверки. Поэтому сводить обороты по одним лишь данным API недостаточно.
Нужно ли ограничивать доступ по IP?
Фильтрация на стороне платформы — про входящие запросы к API: она не обязательна и включается для проекта по запросу, см. Аутентификация.
Обратное направление: если политика безопасности требует принимать вебхуки только с адресов платформы, список IP-адресов I-Free для вашего allowlist выдаёт персональный менеджер.