Настройки и Статусы

Статус-коды

Gateway возвращает один из следующих статусов в поле status.

Статус	Описание
`pending`	Операция в обработке: ожидание 3DS, коллбека от провайдера или подтверждения перевода
`approved`	Платёж подтверждён. Business Service финализирует транзакцию
`declined`	Отказ. Обязательно передать причину в `reason` / `details` / `error` / `declination_reason`
`refunded`	Полный или частичный возврат
`expired`	Время жизни платёжной сессии истекло

При status: "declined" отсутствие причины вызовет ошибку Declined payment must have a reason.

Блок `settings`

При каждом запросе (POST /pay, POST /payout) Business Service передаёт блок settings. Gateway не хранит собственные ключи — все параметры приходят динамически.

Структура

"settings": {
  "api_key": "секретный_ключ_провайдера",
  "sign_key": "ключ_для_подписи_JWT_коллбеков",
  "sandbox": false,
  "host2host": true
}

Поля

Параметр	Тип	Описание
`api_key`	string	Ключ аутентификации для API провайдера
`sign_key`	string	Ключ для подписи JWT (HS512) при отправке коллбеков в Business и для шифрования `merchant_private_key`. См. Callbacks и JWT
`sandbox`	boolean	Режим песочницы провайдера
`host2host`	boolean	Флаг H2H-режима
`gateway_settings`	object	Настройки методов, таймаутов и периодичности проверки статуса
`gateway_settings.processing_method`	string	Метод отправки запросов: `http_requests` или `rabbit`
`gateway_settings.full_link`	string	Полный URL Gateway (для `http_requests`)
`gateway_settings.rabbit_url`	string	URL RabbitMQ (для `rabbit`)
`gateway_settings.rabbit_user`	string	Пользователь RabbitMQ
`gateway_settings.rabbit_password`	string	Пароль RabbitMQ
`gateway_settings.methods`	object	Индивидуальные настройки методов
`gateway_settings.methods.<method>.response_timeout`	integer	Таймаут запроса в секундах (по умолчанию 15)
`gateway_settings.methods.<method>.final_waiting_seconds`	integer	Задержка перед первой проверкой статуса (по умолчанию 15)
`gateway_settings.methods.<method>.enable_status_checker`	boolean	Включение периодической проверки статуса
`gateway_settings.status_checker_time_rates`	object	Интервалы повторов проверки статуса в формате `"1-3": 30` (для попыток 1–3 ждать 30 сек.)
`assets`	object	Файлы (сертификаты) в base64
`validate_signature`	boolean	Требовать подпись X-SIGNATURE в запросе к Gateway
`custom_host`	string	Пользовательский хост для URL
`enable_routing`	boolean	Режим роутинга между шлюзами
`enable_update_amount`	boolean	Разрешить обновление суммы по коллбеку
`enable_change_final_status`	boolean	Разрешить смену финального статуса
`decline_payout_on_request_error`	boolean	Отклонять выплату при ошибке запроса

`sign_key` — использование

settings.sign_key применяется для:

Подписи JWT при отправке коллбека в Business: заголовок Authorization: Bearer <JWT> (алгоритм HS512)
Шифрования merchant_private_key (AES-256-CBC) в поле secure коллбека
Верификации входящего коллбека на стороне Business

Подробнее — в Callbacks и JWT.

Поддерживаемые методы

pay, payout, status, callback, refund, confirm_request, decline_request, confirm_secure_code, resend_otp, next_payment_step.

Типы реквизитов (`bank_account.requisite_type`)

Значение	Описание
`card`	Карта
`sbp`	СБП (Система Быстрых Платежей)
`account`	Банковский счёт
`link`	Ссылка
`url`	URL

Значения `kind` в логах

pay, payout, status, callback, refund, confirm_request, decline_request, confirm_secure_code, next_payment_step.

Настройки и Статусы

Статус-коды

Блок settings