Выплата на карту

Метод создания выплаты на карту с корпоративной карты Сбер (Sber Business Card).

Выплата создаётся в статусе processing, в ответе приходит redirect_url для подтверждения операции в Сбер. После подтверждения статус выплаты обновляется методом подтверждения выплаты.

URL

Метод: POST

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

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

Название	Тип данных	Обязательно	Описание
`amount`	integer	Да	Сумма в копейках
`transaction`	string	Да	Уникальный номер транзакции на стороне мерчанта
`description`	string	Да	Описание к транзакции. Максимум 210 символов.
`session_id`	string	Да	Идентификатор авторизованной сессии Сбер
`business_card_id`	string	Да	Идентификатор корпоративной карты Сбер, с которой выполняется выплата
`recipient_pan`	string	Условно	PAN карты получателя
`customer_card`	json	Условно	Объект привязанной карты покупателя
∟`customer_key`	string	Да	Идентификатор покупателя в системе продавца
∟`customer_card_token`	string	Да	Токен привязанной карты
`user_crypto_type`	string	Нет	Криптопрофиль пользователя Сбер: `SMS` или `Token`. По умолчанию `SMS`.
`payout_draft_id`	integer	Нет	ID черновика выплаты. Черновик подтверждается вместе с выплатой.
`customer`	string	Нет	Email / телефон клиента
`extra_data`	json	Нет	Дополнительные данные
`fiscal_data`	json	Нет	Фискализация чека по 54-ФЗ

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

{
  "recipient_pan": "4111111111111111",
  "amount": 10000,
  "transaction": "f4462ba6-37c5-4455-b0b2-53b179f7a25c",
  "description": "Выплата по договору №123",
  "session_id": "11111111-1111-1111-1111-111111111111",
  "business_card_id": "business-card-id",
  "user_crypto_type": "SMS",
  "customer": "user@example.com"
}

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

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

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

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

Внимание

Валидация подписи выполняется по фактическому телу запроса. Подписывайте ровно тот JSON, который отправите в API (без изменения порядка полей, дополнительных преобразований или пересериализации между шагами).

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

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

200: OK422: Unprocessable Entity5XX: Ошибка

{
  "order": {
    "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
    "status": "processing",
    "transaction": "f4462ba6-37c5-4455-b0b2-53b179f7a25c",
    "amount": 10000,
    "commission": 0,
    "description": "Выплата по договору №123",
    "additional_data": {
      "auth_code": null,
      "rrn": null
    },
    "error_code": null,
    "error_message": null,
    "created_at": "2026-07-29T10:00:00"
  },
  "transaction": null,
  "status": "processing",
  "redirect_url": "https://sber.example/#/transfer-creator/external-id"
}

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

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

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

Название	Тип данных	Описание
`order`	json	Объект выплаты
∟`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	Дата создания транзакции
`transaction`	string	Не используется в данном методе, приходит со значением `null`
`status`	string	Статус транзакции
`redirect_url`	string	Ссылка для подтверждения операции в Сбер

Обратный редирект

Ссылку redirect_url необходимо открыть для подтверждения операции в интерфейсе СберБизнес. Чтобы пользователь после подписания вернулся на страницу мерчанта, в конец полученной ссылки добавляется параметр backUrl с адресом возврата, закодированным URLEncode:

{redirect_url}?backUrl=https%3A%2F%2Fmerchant.example.com%2Fpayout-result

Если backUrl не указать, пользователь после подписания не сможет вернуться на платформу мерчанта. Подробнее — в разделе Общее.

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

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

Коды ошибок

Код	Описание
`20001`	Неверный api-key
`20002`	Неверная подпись
`20003`	Payout профиль не привязан к магазину
`20005`	Ошибка от PSP сервиса
`20007`	Транзакция совершалась прежде
`20015`	Недостаточно средств
`20019`	Превышен лимит выплат по магазину
`20020`	Получатель не задан
`20038`	Некорректный номер черновика
`20040`	Черновик выплаты не найден
`20041`	Итоговое поле `description` превышает допустимую длину
`20042`	Данные из выплаты и черновика выплаты не совпадают
`20098`	Ошибка валидации полей запроса