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

payments/confirm - Подтверждение оплаты

  • HTTP-метод: POST
  • URL: /payments/confirm
  • Форма взаимодействия: Сервер-сервер
  • Формат тела запроса: application/json
  • Аутентификация: HTTP Basic Auth (PublicId / ApiSecret)
  • Назначение: подтверждение (списание) оплаты, проведённой по двухстадийной схеме через payments/cards/auth или payments/tokens/auth. До подтверждения сумма захолдирована и клиент ей воспользоваться не может.

URL

1
https://cloud.wallet.kvell.group/payments/confirm

1
/payments/confirm

Структура запроса

Поле Тип Обяз. Описание
TransactionId int ✔ Номер транзакции в системе.
Amount decimal ✔ Сумма подтверждения в валюте транзакции. Может быть меньше суммы холдирования (частичное подтверждение).
JsonData json Любые другие данные, которые будут связаны с транзакцией, в том числе инструкции для формирования чека.
SplitData array Список товаров для confirm реального холда. Наше расширение — приоритетнее списка, переданного в payments/cards/auth/payments/tokens/auth (если не передан, используется тот).

Структура ответа

Ответ содержит только Success и Message — Model не заполняется.

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

1
2
3
4
{
  "TransactionId": 455,
  "Amount": 65.98
}

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

1
2
3
4
5
{
  "Success": true,
  "Message": null,
  "Model": null
}

1
2
3
4
{
  "Message": "<описание причины отказа>",
  "Success": false
}

Примечания

  • Подтвердить можно только транзакцию, находящуюся в статусе Authorized (см. Статусы транзакции).
  • У двухстадийной карточной оплаты есть ограниченный срок на подтверждение (обычно до 7 дней в зависимости от типа карты) — если не подтвердить вовремя, холд автоматически отменяется.