Помощь с интеграцией и сообщения об ошибках документации.

ключи партнёра: префикс, метка, активность, даты. сырые ключи никогда не возвращаются.

ключ отсутствует или недействителен

legacy service-ключи не принимаются: нужен партнёрский api-ключ

превышен лимит запросов (по умолчанию 60/мин на api-ключ; для сессионных кабинетных операций — на партнёра); заголовок retry-after даёт секунды до сброса окна

создаёт новый ключ fl_live_… (аутентификация — сессия партнёра, не api-ключ: ключ не может выпускать ключи). сырое значение возвращается ровно один раз — сохраните его сразу.

ключ создан; сырое значение — один раз

сессия кабинета отсутствует или истекла

доступ запрещён; требуется сессия кабинета, не api-ключ

деактивирует ключ партнёра по его id (аутентификация — сессия партнёра). идемпотентно: для чужого id совпадений нет, ошибка не возвращается.

ключ деактивирован (или уже был)

возвращает total (всего зачислено), used (подтверждённый lifetime-расход), reserved (в открытых резервах задач), available (доступно = total − used − reserved, не ниже 0) и флаг islow. суммы — в франках (₣), внутренней учётной единице платформы.

создаёт счёт через t-bank business; при оплате баланс зачисляется автоматически (₽→₣ 1:1). лимит: 3 запроса/мин. в примере замените реквизиты на свои; expectedprofilerevision берите из текущего ответа get /v1/billing/legal-invoices/profile.

счета юрлица со статусами, суммами и датами зачисления.

page

limit

профиль компании для выставления счетов (инн, название, адрес и т.д.).

создаёт или обновляет профиль компании для счетов. в примере замените реквизиты на свои; expectedprofilerevision берите из текущего ответа get /v1/billing/legal-invoices/profile.

pdf-файл счёта (inline; иногда — редирект на файл банка). лимит: 12 запросов/мин.

редирект на pdf-файл банка

запрашивает актуальный статус счёта у банка. лимит: 6 запросов/мин.

создаёт qr-ссылку оплаты счёта через сбп b2b. лимит: 6 запросов/мин.

список платёжных операций пополнения с их статусами (pending/authorized/confirmed/canceled/rejected/failed). возвращает последние 50 операций.

создаёт платёжную ссылку t-bank для пополнения баланса (₽→₣ 1:1). заголовок idempotency-key обязателен: повтор с тем же ключом возвращает тот же платёж, а не создаёт новый. сохранение карты не доступно программно. ссылка открывается плательщиком в браузере. лимит: 3 запроса/мин.

ключ идемпотентности (до 128 символов; повтор с тем же ключом и той же суммой возвращает тот же платёж, иная сумма — 409)

idempotency-key

платёж создан (или возвращён существующий): paymenturl для оплаты

нет/некорректный idempotency-key или сумма вне диапазона

базовая витрина цен по семействам (видео/изображения/аудио/текст/обработка) с единицами тарификации. все цены — во франках: внутренней расчётной единице платформы (не валюта); поле item.unitofaccount = 'франки'. поле item.currency — устаревший синоним unitofaccount (переходный период, будет удалено). ответ не кэшируется (no-store); перечитывать достаточно раз в 24 часа (refreshafterseconds).

оценка стоимости операции без побочных эффектов, по вашему тарифу (тот же механизм, что резервирует средства при запуске). передайте модель и параметры; url-медиа не нужно — только счётчики референсов.

параметры планируемой операции

квота стоимости по действующему тарифу

оценка стоимости запуска

действующий тариф (base/pro/max/ultra), назначенный и заработанный планы, lifetime-расход (₣), следующий уровень и сколько осталось до него, процент скидки от базовой цены.

постраничный журнал операций: тип (topup/reservation/confirm/refund; debit — редкие легаси-строки), сумма ₣, цена за единицу, задача, дата, атрибуция. пагинация page/limit (limit ≤ 100).

фильтр по типу транзакции (debit — легаси-строки)

type

чьи пополнения показывать: все / компании / личные

attribution

datefrom

dateto

список транзакций с пагинацией

выгрузка журнала в csv (attachment). те же фильтры, что у списка; не более 10 000 строк за выгрузку — при превышении в конец добавляется строка-комментарий `# truncated: …` с полным количеством.

формат выгрузки; единственный вариант — csv

format

чьи пополнения включать: все / компании / личные

экспорт транзакций в csv

подтверждённый расход по дням utc: confirm минус возвраты, не привязанные к задачам.

последние 50 доставок партнёра со статусами (pending/delivering/delivered/uncertain/dead_lettered), попытками и кодами ответов.

endpointid

фильтр по статусу доставки

status

ставит доставку (uncertain, dead_lettered или delivered) обратно в очередь с тем же eventid. лимит: 30 запросов/мин.

идентификатор доставки

доставка пере-в-очереди

эндпоинты партнёра: url, подписки, активность. секреты никогда не возвращаются.

список вебхук-эндпоинтов

создаёт эндпоинт; секрет whsec_… возвращается ровно один раз. url — публичный https; внутренние адреса отклоняются. до 10 эндпоинтов на партнёра. лимит: 10 запросов/мин.

эндпоинт создан; секрет — один раз

зарегистрировать эндпоинт

удаляет эндпоинт партнёра; его ожидающие доставки исчезают вместе с ним.

идентификатор эндпоинта

генерирует новый подписывающий секрет; новое значение возвращается ровно один раз. прежний секрет действует ещё 6 часов (grace-окно): доставки подписываются новым секретом (x-franklab-signature) и дополнительно прежним (x-franklab-signature-previous) — приёмник в grace-окне может проверять любую из двух подписей. ответ содержит previoussecretvaliduntil — конец окна. по истечении окна прежний секрет затирается. лимит: 10 запросов/мин.

ставит в очередь событие webhook.test ровно для этого эндпоинта — проверьте приём и подпись. лимит: 6 запросов/мин.

событие поставлено в очередь

Поддержка

Разобраться с AI-ассистентом

Что приложить к вопросу