Чего пока нельзя
Возврат на карту и другие пределы платформы
Честный список пределов. Прочтите до того, как встроите платежи в свой сценарий, а не после.
Возврат денег на карту — только целиком
POST /v1/refunds работает: деньги возвращаются на карту клиента.
Но частичный возврат невозможен — банк принимает только идентификатор
операции, суммы в запросе нет. Запрос на часть суммы получит явную ошибку.
И срок возврата нам неизвестен: отдельного метода возврата у банка нет, возврат делается отменой самой операции, а до каких пор её можно отменить, банк не назвал. Не закладывайте в сценарий возврат по старому платежу, не спросив нас.
Мы сознательно возвращаем явную ошибку вместо мнимого успеха: платёж, помеченный возвращённым, но не возвращённый на деле, развалил бы ваш учёт молча и обнаружился бы через месяц.
Пока возвраты оформляются на стороне банка вручную. Если ваш сценарий без возвратов не работает — отмена подписки с перерасчётом, возврат товара — решите это до запуска: например, зачётом на следующую покупку.
Появление возврата зависит не от нас: как только банк передаст операцию, метод заработает без изменений в вашей интеграции — он уже на месте и уже описан в справочнике.
Фискальный чек
Чек по каждой продаже требует закон, и выписывает его банк-эквайер на своей стороне — не платформа. Состав заказа в наш API не передаётся: полей для позиций, кодов ИКПУ и ставок НДС в запросах нет и не ожидается.
Из этого следует практическое: реквизиты продавца и описание товара или услуги настраиваются у банка заранее, при подключении, а не приходят с каждым платежом. Если вы продаёте одну услугу — это работает как есть. Если у вас корзина с разными позициями в одном чеке — напишите нам до подключения, такую схему надо согласовывать с банком отдельно.
Схема свежая и на боевом контуре ещё не включена. Пока не включена — чека от нас не ждите; если чек вам нужен сегодня, выписывайте его своей кассой.
Остальные пределы
- Выплаты на карту (payout) — по той же причине: операции у банка нет.
- Частичная оплата и оплата несколькими картами. Заказ оплачивается целиком и одной картой.
- Расписания подписок. «Subscribe» означает возможность списать когда нужно, а не движок тарифов с периодами и досписаниями. Когда списывать — решаете вы; мы предоставляем списание с сохранённой карты.
- Кошелёк покупателя. Покупателя как сущности у нас нет — есть ваш
customerRef. Список сохранённых карт вы показываете сами, своим интерфейсом. - Остаток на карте клиента. Банк не даёт метода запроса баланса: узнать,
хватает ли средств, можно только попыткой списания — по отказу
INSUFFICIENT_FUNDS. - Валюты, кроме сума. Только UZS.
- Рассрочка. Это устройство продажи, а не оплаты; отдельная работа с банком и налоговой.
Частота обращений
Не более 600 обращений в минуту на продукт. При превышении приходит код 429
и заголовок Retry-After с числом секунд — дождитесь и повторите, это
безопасно: запрос до нас не дошёл.
Отдельно действует предел на стороне банка, общий для всей платформы. Если вы ждёте всплесков — распродажа, запуск, рассылка — предупредите нас заранее, чтобы мы согласовали запас с банком.
Что-то из этого мешает вам подключиться?
Напишите — часть пределов упирается в договор с банком, и знание о конкретном сценарии помогает их двигать. Обратное тоже верно: пока никто не просил, мы не станем строить движок подписок наугад.
Дальше по теме
Остаток на карте — по разрешению
GET /subscribe/v1/cards/{card}/balance по умолчанию выключен для
продукта. Это не технический предел, а правило про чужие данные: остаток
клиента мы открываем под конкретную задачу. Подробнее —
«Карты».