Отказ от платежа

Основные положения

Сервис предназначен для отказа от платежа. Сервис может применяться в тех случаях, когда заказ инициирован, но не будет оплачен, при этом необходимо завершить его до истечения тайм-аута. Например, покупатель передумал или хочет изменить заказ, а на стороне предприятия при изменении корзины номер заказа остается неизменным.

В процессе отказа осуществляется изменение статуса созданного заказа с In Process на Declined, со стороны предприятия можно инициировать оплату нового заказа с тем же номером OrderNumber.

Заказ будет завершен со статусом Declined в том случае, если на момент вызова сервиса оплата только начата (например, покупатель еще не ввел данные карты), и еще не отправлена в процессинг транзакция авторизации, в противном случае сервис вернет ошибку (такие заказы следует отменять с помощью сервиса для отмены заказа).

Описание сервиса

Для обращения к веб-сервису необходимо отправить запрос (методом POST с content-type application/json) на сервер ASSIST по адресу: https://<server-name>/api/v1/order/cancel.cfm.

Входные параметры сервиса:

В запросе необходимо передать HTTP-заголовок Authorization:

Bearer <token>, где <token> — токен доступа.

Для получения токена доступа необходимо использовать сервис https://<server-name>/api/v1/auth/login.cfm с указанием audience="POS" и components="ws/cancelbynumber".

Для получения токена с возможностью отказа от платежа у пользователя должны быть права на отказ от платежа (Web Services -> Отмена по номеру заказа). Если прав недостаточно, то при попытке получить токены с audience="POS" будет получен ответ:

{"faultcode":"159","faultstring":"no scopes"}

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

POST https://<server-name>/api/v1/order/cancel.cfm
headers: [Authorization: Bearer eyJraWQiOiIwYWZlZTE0Mi1hMGFmLTQ0MTAtYWJjY...65s0sKKV1TefvGecmFbCqizljU4toyROW54f0Y, Content-type: application/json]
Body:
{
      "merchant_id": "123456",
      "ordernumber": "dd2"
}

Выходные параметры

При успешном изменении статуса заказа сервис вернет новый статус заказа со значением Declined:

{"cancel": {"orderstate": "Declined"}}