API ЮKassa
Помощь
Подключить ЮKassa
Метод confirmPayment
Описание
Завершение успешного перевода на счет магазина. Нужен для работы с отложенными переводами.
Особенности
  • Если для магазина предусмотрены отложенные переводы в ЮKassa, то все переводы в этот магазин будут отложенными, т. е. будут выполняться в два шага: заморозка средств на банковской карте плательщика и списание средств с карты.
  • Сумма, указанная в запросе подтверждения отложенного перевода может быть меньше суммы заморозки, в этом случае остаток средств будет автоматически возращен на банковскую карту плательщика.
  • Если время подтверждения для отложенного перевода истекло, то, несмотря на верные значения параметров запроса, в ответе будет ошибка. Время подтверждения определяется на стороне банка, через который проходит операция, для каждого банка индивидуально.
Формат запроса
Адрес для вызова операции
https://shop.yookassa.ru/webservice/mws/api/confirmPayment
Параметры запроса
ПараметрТипОписание
requestDTdateTimeВремя формирования запроса на выполнение операции по часам системы магазина.
orderIdlongНомер транзакции отложенного перевода, выдается ЮKassa в параметре invoiceId.
amountCurrencyAmountСумма перевода, который необходимо провести.
currencystring,
3 символа
Буквенный код валюты перевода. Указывается в соответствии с ISO 4217:2008.
ym_merchant_receiptstring
Данные для формирования чека в формате JSON (так же, как в платежной форме).
Параметр передается и является обязательным, если:
  • вы настроили взаимодействие со своей онлайн-кассой через ЮKassa и передаете в платежной форме данные для формирования чека;
  • сумма перевода (amount) отличается от исходной, переданной в платежной форме (проводится частичный клиринг).
Пример запроса
requestDT=2011-07-02T20:38:00.000Z&orderId=12345&amount=10.00&currency=RUB
Формат ответа
В ответ приходят параметры, общие для всех типов запросов на исполнение финансовых операций.
Пример ответа
XML
<confirmPaymentResponse
         orderId="12345"
         status="0" error="0"
         processedDT="2011-07-02T20:38:01.000Z"
         />
Что почитать еще
Сценарий отложенной оплатыПравила обработки запросовКоды ошибокТипы данных