Smerch — API интеграции для мерчантов
    • Быстрый старт
    • Возвраты
    • Песочница, ошибки и go-live
    • Вебхуки (исходящие колбэки)
    • Авторизация и HMAC
    • Балансы и курсы
    • Платежи
    • Выводы (выплаты)
    • Авторизация
      • Проверить, что API отвечает
        GET
    • Балансы
      • Посмотреть балансы
        GET
    • Выводы
      • Создать вывод средств
        POST
      • Посчитать вывод без списания
        GET
      • Получить вывод по UUID
        GET
    • Возвраты
      • Сделать возврат по платежу
        POST
    • Песочница
      • Песочница: симулировать отказ оплаты
        POST
      • Песочница: отказ, затем запоздавшая оплата
        POST
      • Песочница: симулировать успешную оплату
        POST
      • Песочница: симулировать истечение платежа
        POST
    • Платежи
      • Список платежей
        GET
      • Создать платёж
        POST
      • Найти платёж по вашему external_id
        GET
      • Получить платёж по UUID
        GET
    • Вебхуки
      • Посмотреть настройки webhook
        GET
      • Задать URL для колбэков
        PUT
      • Журнал доставок webhook
        GET
      • Сменить secret подписи webhook
        POST
      • Отправить тестовый колбэк
        POST
      • Событие: изменился статус платежа
      • Событие: изменился статус вывода
    • Balances
      • Service method
    • Payments
      • Service method
    • Schemas
      • CreatePayoutRequest
      • CreateRefundRequest
      • CreateTransactionRequest
      • CursorMeta
      • ErrorResponse
      • HealthResponse
      • IntegrationBalancesResponse
      • MerchantBalance
      • MerchantPayoutCallback
      • MerchantTransactionCallback
      • PayoutQuoteResponse
      • PayoutResponse
      • RatesResponse
      • RefundResponse
      • StructuredError
      • TransactionResponse
      • TransactionCursorPage
      • ValidationErrorResponse

    Балансы и курсы

    Балансы#

    GET /api/v1/integration/balances
    Возвращает бакеты ledger мерчанта (точные поля — в схеме), обычно:
    БакетСмысл
    pendingденьги ещё не доступны к выводу
    availableможно выводить (с учётом лимитов/правил)
    frozenзаморожено (диспут, риск, ops)
    Перед выводом лучше перечитать баланс ближе к действию: кэш на вашей стороне устаревает.

    Курсы#

    GET /api/v1/integration/rates
    Отдаёт FX-котировки, которые платформа использует для конвертации (например fiat ↔ crypto).
    Правила:
    не хардкодьте курс у себя;
    для вывода с конвертацией дополнительно смотрите payout quote;
    курс из rates — справочный снимок; финальная экономика операции определяется quote/create ответа.
    Modified at 2026-07-23 06:43:53
    Previous
    Авторизация и HMAC
    Next
    Платежи
    Built with