Перейти к содержанию

Совершение выплаты

Метод совершения выплаты по реквизитам получателя.

URL

Метод: POST

  • Production: https://api.pay.kvell.group/v1/orders/payout/sbp
  • Stage: https://api.pay.stage.kvell.group/v1/orders/payout/sbp

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

Название
 Тип Обязательно Описание
amount string Да Сумма в копейках
bank_id string Да Bank Id полученный из списка банков
bank_bic string Нет Бик банка полученый из списка банков. Зависит от банка-эквайера. Уточнять у менеджера.
fio string Да ФИО получателя
fio_check boolean Нет Флаг для указания, что требуется проверка совпадения переданного ФИО и возвращаемого НСПК
phone string Да Номер телефона получателя. Только цифры.
nspk_id string Нет Платежная ссылка, полученная на этапе вызова метода статуса возможности выплаты.При отсутствии в запросе, ссылка будет получена отдельным запросом в НСПК в рамках выполнения платежа.
request_id string Нет Параметр полученный при вызове метода возможности выплаты. Зависит от банка-эквайера. Уточнять у менеджера.
description string Да Описание к транзакции
transaction string Да Уникальный номер транзакции на стороне мерчанта
customer string Нет Email / телефон клиента
extra_data json Нет Дополнительные данные
fiscal_data json Нет Фискализация чека по Ф3-54

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

{
  "phone": "79991234567",
  "fio": "Иванов Иван Иванович",
  "bank_id": "100100000014",
  "amount": 100,
  "transaction": "string",
  "description": "string",
  "customer": "string"
}

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

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

Формирование подписи

При формировании запроса необходимо использовать ЭЦП. Используется алгоритм RSA/SHA256. Данное сообщение необходимо передавать в заголовке HTTP запроса в параметре X-Signature. Алгоритм формирования подписи такой же как и при совершении выплаты.

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

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

{
  "id": "string",
  "status": "string",
  "transaction": "string",
  "amount": 0,
  "commission": 0,
  "description": "string",
  "created_at": "string"
}

{
  "errors": [
    {
      "message": "string",
      "code": 0
    }
  ]
}
  • Если получен ответ со статусом 5XX, транзакцию необходимо оставить в обработке и отправить запрос на метод получения статуса транзакции.
  • Данные ошибки могут возникнуть по различным причинам: на стороне взаимодействия сети, технических сбоев сервера или ПО.
  • В случае повторного возникновения данной проблемы рекомендуется обратиться в службу поддержки.

Если выплаты СБП настроены с помощью подтверждения через OTP-код, то ответ придет статус отправки OTP-кода wait_confirm, в других случаях ошибка отравки OTP-кода:

{
  "status": "wait_confirm"
}

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

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