С помощью MWS магазин может совершать возвраты, подтверждать и отменять отложенные платежи, а также повторять платежи банковской картой или через Mir Pay (если плательщик на это согласился). Конкретному магазину могут быть доступны не все запросы. Это зависит от особенности реализации данного протокола и от условий договора с ЮKassa.
https://shop.yookassa.ru
Запросы передаются по протоколу HTTP 1.1 методом POST.
Формат передачи параметров в запросе:
- каждый параметр передается в формате
{ключ}={значение}в теле POST-запроса; - MIME-тип:
application/x-www-form-urlencoded; - кодировка символов: UTF‑8.
Результат выполнения запроса будет возвращен в виде XML-документа в теле ответа на HTTP-запрос. Перечень возможных HTTP кодов ответа
Документ формируется согласно стандарту XML 1.0 (Fifth Edition):
- имена элементов и атрибутов чувствительны к регистру
- MIME-тип: application/xml;
- кодировка символов: UTF‑8.
Ответы ЮKassa на все типы запросов на исполнение финансовых операций содержат одинаковый набор параметров:
| Параметр | Тип | Описание |
|---|---|---|
| status | int | Результат выполнения операции. По значению этого поля магазин должен принимать решение о состоянии запроса (см. раздел Коды состояний запроса). |
| error | int | Код ошибки выполнения запроса (см. раздел Коды ошибок). Является дополнительной расшифровкой к полю status. Опциональное поле. |
| clientOrderId | ClientTransactionNumber | Копия параметра clientOrderId запроса. Используется для финансовых операций. |
| processedDT | dateTime | Время обработки запроса по часам ЮKassa. |
| techMessage | string | Опциональное поле. Может содержать дополнительный поясняющий текст к ответам сервера. Этот текст содержит техническую информацию и не должен отображаться в каком-либо интерфейсе магазина. |
Магазин и ЮKassa взаимодействуют по протоколу HTTPS. Для работы с MWS магазину необходимо получить сертификат X.509, выданный удостоверяющим центром ЮMoney, с помощью которого магазин будет формировать запросы к ЮKassa.
Коды состояний запросаКоды ошибокЗапрос возврата успешного переводаHTTP-коды ответа