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

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

Подтверждение выплаты на карту с помощью OTP-кода.

Если у магазина включена опция подтверждение выплаты на карту с помощью OTP-кода, то необходимо вызывать данный метод. Для уточнения деталей обратитесь к менеджеру.

URL

Метод: POST

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

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

Название
 Тип данных Обязательно Описание
transaction string Да Уникальный номер транзакции на стороне мерчанта
otp string Да OTP-код (одноразовый пароль)

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

{
  "transaction": "string",
  "otp": "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, транзакцию необходимо оставить в обработке и отправить запрос на метод получения статуса транзакции.
  • Данные ошибки могут возникнуть по различным причинам: на стороне взаимодействия сети, технических сбоев сервера или ПО.
  • В случае повторного возникновения данной проблемы рекомендуется обратиться в службу поддержки.

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

Название Тип данных Описание
amount integer Сумма в копейках
status string Статус транзакции
id string ID платежа в системе
description string Описание к транзакции
transaction string Уникальный номер транзакции на стороне мерчанта
created_at string Дата создания транзакции
commission string Комиссия в копейках