Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

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 – Отказ покупателя
3 – Мошенническая операция

2

Причина отмены или возврата

Language

Нет

RU – русский
EN – английский

RU

Язык выдачи результатов

ClientIP

Нет

Максимум 15 цифр, 4 разделителя «.»


IP компьютера оператора, производящего отмену/возврат.

Format

Нет

1 – CSV
3 – XML
4 – SOAP
5 - JSON

Формат входных данных

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

Externalrefundid

Нет2

От 10 до 100 символов (разрешенные символы [A-Za-z0-9\-_]


Внешний идентификатор отмены (уникальное значение в пределах одного заказа)

Customer

Нет23

Структура данных


Параметры покупателя

...

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

Anchor
2
2


2Параметр используется только для сервиса wscancel и форматов JSON и SOAP.

Anchor
3
3


3Параметр необходим только для отмен платежей по ЕРИП.

В структуре передаются следующие параметры покупателяполучателя:

Название

Обязательноеполе

Тип значения

Описание

bankcode

Да

int

Условный номер участника расчетов, присваиваемый банкам национальной платежной системы РБ (банка получателя)

accountnumber

Да

string(50)

Номер лицевого счета клиента системы «Расчет» (получателя).

firstname

Нет

string(29)

Имя клиента системы «Расчет».

lastname

Нет

string(29)

Фамилия клиента системы «Расчет»

secondname

Нет

string(29)

Отчество клиента системы «Расчет».

...