Отмена и возврат

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

URL запроса для формата HTTP POST: https://<SERVER-NAME>/cancel/cancel.cfm

URL запроса для формата SOAP: https://<SERVER-NAME>/cancel/wscancel.cfm

Если предприятие работает с программой лояльности «Спасибо от СберБанка», и в заказе может быть две успешные операции оплаты (картой и баллами), а также операция начисления баллов, рекомендуем для отмен пользоваться сервисом https://<SERVER-NAME>/cancel/wscancel.cfm.

Список параметров запроса:

Название	Обязательное поле	Принимаемые значения	Значение по умолчанию	Описание
Billnumber	Да	15 или 16 цифр Расширенный формат		Номер платежа, соответствующий заказу в системе АПК Ассист, допускается передача расширенного номера платежа
Merchant_ID	Да	Число		Идентификатор предприятия в АПК Ассист
Login	Да	8 - 20 символов		Логин (лат. буквы и цифры, символ _)
Password	Да	8 - 20 символов		Пароль (лат. буквы и цифры)
Amount	Нет*	Число, 15 цифр (разделитель «.»)	Сумма авторизации	Сумма возврата средств
Currency	Нет*	3 символа	Код валюты авторизации	Код валюты отмены или возврата средств. Может быть использован только код валюты авторизации
CancelReason	Нет	1 – Отказ магазина 2 – Отказ покупателя 3 – Мошенническая операция	1	Причина отмены или возврата
Language	Нет	RU – русский EN – английский	RU	Язык выдачи результатов
ClientIP	Нет	Максимум 15 цифр, 4 разделителя «.»		IP компьютера оператора, производящего отмену/возврат.
Format	Нет	1 – CSV 2 – WDDX 3 – XML 4 – SOAP	Формат входных данных, 4 для сервиса wscancel	Формат выдачи результатов

* Параметры Amount, Currency могут присутствовать или отсутствовать в запросе только одновременно. В случае отсутствия параметров операция отмены оплаты будет проведена на полную сумму.

Для совершения операции отмены можно передать параметр billnumber как в обычном формате (если по заказу была одна успешная операция оплаты), так и в расширенном формате. При использовании расширенного формата обязательно должен быть указан номер успешной операции оплаты (в некоторых случаях это может быть не первая по счету операция, например, 5111111000965142.2).

Отмена или возврат средств является успешной, если код возврата операции отмены responsecode AS000 (операция успешно завершена), оба кода firstcode=0, secondcode=0, статус заказа при этом становится Canceled (Отменен) или PartialCanceled (Отменен частично).

Для неуспешной отмены код возврата responsecode принимает значения AS100-AS998. Если запрос на возврат или отмену не может быть обработан, в результате запроса вернутся ненулевые значения параметров firstcode, secondcode.

Для совершения полной отмены заказа, оплаченного картой и бонусными баллами, необходимо передать параметр billnumber в обычном формате, параметры Amount и Currency не передавать.

Для совершения частичной отмены заказа, оплаченного картой и бонусными баллами, необходимо отдельно отправить запрос для каждой операции оплаты. Для частичной отмены операции оплаты по карте передать billnumber в расширенном формате, соответствующий данной операции (например, 5111111000965142.1), и параметры Amount и Currency, соответствующие сумме, которую необходимо вернуть на карту. Для частичной отмены операции оплаты баллами передать billnumber в расширенном формате, соответствующий данной операции (например, 5111111000965142.2), и параметры Amount и Currency, соответствующие сумме баллов, которую необходимо вернуть.

Если при оплате картой и/или баллами были начислены бонусные баллы «Спасибо», то при совершении отмен соответствующие операции отмены начисления будут созданы автоматически.

Тип совершаемой транзакции (on-line отмена, возврат средств (refund), отмена финансовой транзакции, частичная отмена) будет определен системой АПК Ассист автоматически в зависимости от суммы (полная или частичная отмена), процессинга, типа карты, наличия финансовой транзакции для родительской авторизации и причины возврата.

Если предприятие работает с чеком, отмены возможны только по позициям чека, отменяемые позиции чека необходимо передать в параметре ChequeItem, более подробно см. раздел о работе с чеком .

Content

Space Tools