Подтверждение выплаты

Метод обновления статуса выплаты после подтверждения операции пользователем в Сбер. Используется для выплат, созданных методами выплаты на карту и выплаты СБП.

URL

Метод: POST

Production: https://api.pay.kvell.group/v1/orders/payout/sber/confirm
Stage: https://api.pay.stage.kvell.group/v1/orders/payout/sber/confirm

Параметры запроса

Название	Тип данных	Обязательно	Описание
`transaction`	string	Да	Уникальный номер транзакции на стороне мерчанта
`session_id`	string	Да	Идентификатор авторизованной сессии Сбер

Пример запроса

{
  "transaction": "f4462ba6-37c5-4455-b0b2-53b179f7a25c",
  "session_id": "11111111-1111-1111-1111-111111111111"
}

Заголовки запроса

Название	Тип данных	Обязательно	Описание
`X-Api-Key`	string	Да	Уникальный идентификатор магазина
`X-Signature`	string	Да	Подпись

Подпись X-Signature формируется конкатенацией X-Api-Key, transaction, session_id и secret_key. Формируется sha256 от полученной строки:

sha256({X-Api-Key}{transaction}{session_id}{secret_key})

где secret_key - секретный ключ, который находится в настройках магазина мерчанта.

Ответ запроса

Пример ответа

200: OK404: Not Found422: Unprocessable Entity5XX: Ошибка

{
  "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
  "status": "completed",
  "transaction": "f4462ba6-37c5-4455-b0b2-53b179f7a25c",
  "amount": 10000,
  "commission": 0,
  "description": "Выплата по договору №123",
  "additional_data": {
    "auth_code": "123456",
    "rrn": "123456789012"
  },
  "error_code": null,
  "error_message": null,
  "created_at": "2026-07-29T10:00:00"
}

{
  "errors": [
    {
      "code": 20009,
      "message": "Заказ не найден"
    }
  ]
}

{
  "errors": [
    {
      "code": 20098,
      "message": "session_id: Field required"
    }
  ]
}

Транзакцию необходимо оставить в обработке: ответ 5xx не означает, что подтверждение не выполнено.
Порядок действий описан в разделе Обработка ошибок и таймаутов.

Параметры ответа

Название	Тип данных	Описание
`id`	string	ID платежа в системе
`status`	string	Статус транзакции
`transaction`	string	Уникальный номер транзакции на стороне мерчанта
`amount`	integer	Сумма в копейках
`commission`	integer	Комиссия в копейках
`description`	string	Описание к транзакции
`additional_data`	json	Дополнительные данные (код авторизации, RRN)
`error_code`	string	Код ошибки (при наличии)
`error_message`	string	Сообщение об ошибке (при наличии)
`created_at`	string	Дата создания транзакции

Список статусов

Название	Описание
`new`	Новая транзакция
`processing`	Транзакция обрабатывается
`canceled`	Транзакция отклонена
`completed`	Транзакция выполнена

Статус выплаты

Если выплата осталась в статусе processing, итоговый статус необходимо получить методом статуса транзакции.

Коды ошибок

Код	Описание
`20001`	Неверный api-key
`20002`	Неверная подпись
`20009`	Заказ не найден
`20098`	Ошибка валидации полей запроса