35дд. Руководство оператора Документ предназначен для внутреннего использования Введение 4 Вход в систему 5

• Название: Руководство оператора Документ предназначен для внутреннего использования Введение 4 Вход в систему 5
• Дата: 25.10.2022
• Размер: 2.53 Mb.
• Имя файла: eCom_merchant_instruction_ru .docx
• Тип: Руководство; #754079
• страница: 7 из 9

Обычно отмена платежа производится в АРМ. В случае если коммерсанту нужно автоматизировать этот процесс, то можно воспользоваться специальным вызовом API.

Запрос на отмену платежа должен быть в отправлен в ecom методом POST на адрес https://host/ecom/api

Параметры запроса коммерсанта на отмену заказа:

Наименование	Обязательность	Формат	Описание
ORDER	Да	N(6 - 22)	Номер заказа, должен быть тот-же что и в операции заказа
MERCHANT	Да	C(6 - 15)	Идентификатор коммерсанта
REV_AMOUNT	Да	N(1 - 13)	Сумма отмены (в валюте заказа), должна быть не более суммы заказа! Разделитель - точка
REV_DESC	Да	C(1 – 400)	Описание причины отмены заказа
LANGUAGE	Нет	С(2)	Предпочтительный язык клиента, поддерживаются значения «ru» и «en»
P_SIGN	Да	C(80 - 250)	Подпись заказа

Алгоритм формирования подписи в поле P_SIGN следующий: нужно собрать в одну строку значения полей заказа (без LANGUAGE!) через разделитель «;», затем добавить эту строку к значению секретного ключа SHARED_SECRET (этот ключ индивидуальный для каждого коммерсанта), и вычислить из полученной строки значение хэш SHA512. В строке REV_DESC перед обработкой нужно убрать все переносы строк. Например, на PHP это будет выглядеть примерно так:

vSign=hash("sha512",C_SHARED_KEY.$_POST["ORDER"].";".$_POST["MERCHANT"].";".$_POST["REV_AMOUNT"].";".preg_replace("/\n|\r/g","",$_POST["REV_DESC"]).";"););

Обратите внимание! В продуктовой системе хэш должен вычисляться не в браузере на стороне клиента, а в процедуре на стороне веб-сервера коммерсанта! Пример на странице r_test.html – только для тестирования, секретный ключ SHARED_SECRET ни в коем случае не должен быть доступен кому-либо вне Вашего сервера!
Пример вычисления есть в странице примера https://host/eCom/static/e/test_rev.html.
В ответe вернется результат регистрации операции заказа в формате XML:




0

ok

Возможные коды результата регистрации отмены заказа:

Код	Описание (ru)	Описание (en)
0	Зарегистрирована заявка на отмену заказа '%s' на сумму '%s'	Request of cancellation/refund of order '%s' is registered, amount '%s'
41	Сервис временно недоступен, попробуйте позже. %s.	Service temporary unavailable, try again later. %s.
42	Неправильная сумма: %s	Amount is invalid: %s
43	Сервис Db временно недоступен, попробуйте позже	Db service temporary unavailable, try again later
44	Неправильное значение в поле MERCHANT: '%s'	Merchant is invalid: '%s'
45	Заявка ORDER=%s не найдена	Order '%s' is not found
46	Неправильная подпись!	Signature is invalid!
47	Сумма возврта '%s' больше чем сумма заказа '%s'	Refund amount '%s' is greater than the order amount '%s'
48	Текущий статус заказа не позволяет делать возврат/отмену	Сurrent status of order does not allow to make it refund / cancel
50	Неправильное значение в поле '%s' : '%s'	Value of param '%s' is invalid: '%s'
51	Текущий статус терминала '%s' не позволяет производить операции	Current status of terminal '%s' does not allow operations
52	Операция отмены/возврата через API для терминала '%s' запрещена	API refunding operation for terminal '% s' is forbidden