Page History
...
URL запроса для формата SOAP: https://<SERVER-NAME>/cancel/wscancel.cfm, параметры передаются SOAP запросом, либо в формате JSON (swagger описание: https://docs.belassist.by/swagger/).
Note |
---|
Если предприятие использует такие сценарии оплаты, при которых в одном заказе могут быть две успешные операции оплаты (например, оплата с выполненной ранее предоплатой или оплата с предоставлением скидки), то для совершения отмены необходимо пользоваться сервисом wscancel, который возвращает в ответе результат отмены для каждой операции отдельно во вложенных секциях <operation>. |
Список параметров запроса:
Название | Обязательное поле | Принимаемые значения | Значение по умолчанию | Описание |
Billnumber | Да | 15 или 16 цифр Расширенный формат | Номер платежа, соответствующий заказу в системе АПК Ассист, передача расширенного номера платежа допускается только в том случае, если в заказе не передается чек. | |
Merchant_ID | Да | Число | Идентификатор предприятия в АПК Ассист | |
Login | Да | 8 - 20 символов | Логин (лат. буквы и цифры, символ _) | |
Password | Да | 8 - 20 символов | Пароль (лат. буквы и цифры) | |
Amount | Нет1 | Число, 15 знаков, два знака после разделителя (допустимый разделитель «.») | Сумма авторизации | Сумма возврата средств |
Currency | Нет1 | 3 символа | Код валюты авторизации | Код валюты отмены или возврата средств. Может быть использован только код валюты авторизации |
CancelReason | Нет | 1 – Отказ магазина | 2 | Причина отмены или возврата |
Language | Нет | RU – русский | RU | Язык выдачи результатов |
ClientIP | Нет | Максимум 15 цифр, 4 разделителя «.» | IP компьютера оператора, производящего отмену/возврат. | |
Format | Нет | 1 – CSV | Формат входных данных | Формат выдачи результатов. Если запрос передан в формате SOAP, то ответ также будет в SOAP, в остальных случаях в соответствии с переданным значением формата. |
CustomerExternalrefundid | Нет2 | От 10 до 100 символов (разрешенные символы [A-Za-z0-9\-_] | Внешний идентификатор отмены (уникальное значение в пределах одного заказа) | |
Customer | Нет3 | Структура Структура данных | Параметры покупателя |
...
1 Параметры Amount, Currency могут присутствовать или отсутствовать в запросе только одновременно. В случае отсутствия параметров операция отмены оплаты будет проведена на полную сумму.
Anchor 2 2
2Параметр используется только для сервиса wscancel и форматов JSON и SOAP.
Anchor | ||||
---|---|---|---|---|
|
3Параметр необходим только для отмен платежей по ЕРИП.
В структуре передаются следующие параметры покупателяполучателя:
Название | Обязательноеполе | Тип значения | Описание |
bankcode | Да | int | Условный номер участника расчетов, присваиваемый банкам национальной платежной системы РБ (банка получателя) |
accountnumber | Да | string(50) | Номер лицевого счета клиента системы «Расчет» (получателя). |
firstname | Нет | string(29) | Имя клиента системы «Расчет». |
lastname | Нет | string(29) | Фамилия клиента системы «Расчет» |
secondname | Нет | string(29) | Отчество клиента системы «Расчет». |
...
Название | Значение |
ordernumber | Номер заказа |
responsecode | Код возврата |
recommendation | Рекомендации |
message | Сообщение |
ordercomment | Комментарий |
orderdate | Дата заказа по Гринвичу (GMT) |
amount | Сумма операции |
currency | Валюта операции |
meantypename | Тип платежного средства |
meannumber | Номер платежного средства |
lastname | Фамилия плательщика |
firstname | Имя плательщика |
middlename | Отчество плательщика |
issuebank | Название банка-эмитента |
Email плательщика | |
bankcountry | Страна банка-эмитента |
rate | Курс валюты |
approvalcode | Код авторизации |
meansubtype | Подтип платежного средства |
cardholder | Держатель платежного средства |
cardexpirationdate | Срок действия карты |
ipaddress | IP-адрес плательщика |
protocoltypename | Протокол |
testmode | Тестовый режим |
customermessage | Сообщение о результате для покупателя |
orderstate | Cтатус заказа |
processingname | Процессинг |
operationtype | Тип операции |
billnumber | Расширенный формат billnumber |
orderamount | Оригинальная сумма операции |
ordercurrency | Оригинальная валюта операции |
slipno | Номер финансовой транзакции, отправляемый в процессинг (обычно не используется) |
packetdate | Дата формирования запроса по Гринвичу (GMT) |
signature | Подпись. Формируется по следующему алгоритму: 1. Формируется объединённая строка из параметров (в их строковом представлении, в формате как они переданы в ответе): billnumber, ordernumber, responsecode, orderamount, ordercurrency, meannumber, approvalcode, orderstate, packetdate (без разделителей). |
Пример результата запроса отмены платежа или возврата средств в формате XML:
...