XML-интерфейсы для платежных интеграторов

Добавление продавца платежного интегратора

URL для передачи запроса – https://megastock.com/xml/int/AddMerchant.ashx

Метод – POST

Формат запроса

<ms.request number="">
    <login type=""></login>
    <int_id></int_id>
    <int_wmid></int_wmid>
    <beneficiary type="">
        <legalname></legalname>
        <regcountry></regcountry>
        <legalnumber></legalnumber>
        <taxpayernumber></taxpayernumber>
        <email></email>
        <phone></phone>
        или
        <wmid></wmid>
    </beneficiary>
    <url></url>
    <group></group>
    <keywords></keywords>
    <logourl></logourl>
    <about lang="">
        <name></name>
        <descr></descr>
    </about>
    <nameincomment></nameincomment>
    <geobindings>
        <country id="RU"></country>
        <country id="UA"></country>
        ...
    </geobindings>
    <sign></sign>
</ms.request>

Параметры запроса

название назначение примечание
ms.request/@number Номер запроса Целое число в диапазоне от 1 до 263-1 (9 223 372 036 854 775 807). Номер последующего запроса должен быть больше предыдущего.
login Логин Если Вы имеете доступ к киперу, которым ранее авторизовывались на Мегастоке для регистрации интегратора, укажите WMID этого кипера и установите атрибут type="1".
Если Вы работаете через сервис processing.webmoney.com, укажите Ваш логин на Процессинге и установите атрибут type="2".
int_id Номер, под которым интегратор зарегистрирован в Мегастоке Номер можно узнать на странице со списком сайтов, зарегистрированных на WMID интегратора.
int_wmid WMID интегратора WMID, под которым интегратор зарегистрирован в Мегастоке.
beneficiary Получатель средств Если вы выплачиваете продавцу средства по договору, установите атрибут type="1".
Если вы выплачиваете средства в WebMoney, укажите WMID продавца и поставьте атрибут type="2".
beneficiary/legalname Название юридического лица продавца Указывается если у элемента beneficiary атрибут type="1".
beneficiary/regcountry Страна регистрации юридического лица продавца Указывается в виде двухсимвольного ISO-кода страны, если у элемента beneficiary атрибут type="1".
beneficiary/legalnumber ОГРН продавца Указывается если у элемента beneficiary атрибут type="1".
beneficiary/taxpayernumber ИНН продавца Указывается если у элемента beneficiary атрибут type="1".
beneficiary/email E-mail продавца Указывается если у элемента beneficiary атрибут type="1".
beneficiary/phone Телефон продавца Указывается если у элемента beneficiary атрибут type="1".
beneficiary/wmid WMID продавца Указывается если у элемента beneficiary атрибут type="2". Получатель должен иметь аттестат не ниже персонального.
url URL сайта, где осуществляется прием WebMoney URL указывается вместе с протоколом (http или https). Например, https://top-up.webmoney.com.
group Идентификатор категории товаров/услуг Список категорий каталога Мегасток и их идентификаторов досупен здесь.
keywords Ключевые слова/фразы для поиска магазина в каталоге Указываются через запятую.
logourl Ссылка на файл логотипа продавца Логотип должен иметь размеры 88x31 пиксел. Размер файла не должен превышать 10Кб.
Это поле можно оставить пустым.
about В этом элементе содержится описание продавца на языке, указанном в атрибуте lang Если товары/услуги продавца ориентированы на русскоязычную аудиторию, lang="ru".
Если товары/услуги продавца ориентированы на англоязычную аудиторию, lang="en".
Допустимо добавить два элемента <about> c разными языками.
about\name Название продавца Не более 50 символов.
about\descr Краткое описание магазина  
nameincomment Название продавца в примечании к WM-транзакции Пример примечания: "Payment for Skype, order 12345678" (где Skype - название продавца в примечании).
Имейте ввиду, что названия, регистрируемые для продавцов не должны являться подстроками друг для друга. Например, если вы зарегистрировали продавца с nameincomment=Skype, то зарегистрировать еще одного продавца с nameincomment=Skype1 не получится.
geobindings В этом элементе перечисляется список стран, в которых продавец предоставляет товары/услуги Если территориальных ограничений нет, этот элемент можно оставить пустым.
sign Подпись запроса Для login type="1" строка для подписи создается путем конкатенации параметров: ms.request/@number+login+int_id+int_wmid+url+nameincomment+group Подпись формируется с помошью модуля WMSigner.

Для login type="2" строка для подписи создается путем конкатенации параметров: ms.request/@number+login+int_id+int_wmid+url+nameincomment+group+salt Значение salt (секретное слово на интерфейсы сервиса processing.webmoney.com) можно узнать у менеджера, через которого Вы заключали договор с Процессингом. Подпись формируется по алгоритму SHA1 (получившийся массив байтов преобразуется в последовательность символов по схеме Base64).
Пример формирования подписи на языке C#: string sign = Convert.ToBase64String(SHA1.Create().ComputeHash(Encoding.GetEncoding(1251).GetBytes(stringToSign))); В итоге подпись должна представлять собой строку вида 1ZPMat65eA7iQ0ibGFYx1ZxzyKU=.

Формат ответа

<ms.response>
    <retval></retval>
    <retdescr></retdescr>
    <resourceid></resourceid>
</ms.response>

Параметры ответа

название назначение примечание
retval Код выполнения запроса 0 – заявка на добавление принята.
retdescr Расшифровка кода выполнения запроса  
resourceid Номер, присвоенный сайту в каталоге Мегасток Поле заполнено только при retval=0.

Получение списка зарегистрированных продавцов платежного интегратора

URL для передачи запроса – https://megastock.com/xml/int/GetMerchants.ashx

Метод – POST

Формат запроса

<ms.request number="">
    <login type=""></login>
    <int_id></int_id>
    <int_wmid></int_wmid>
    <startid></startid>
    <itemscount></itemscount>
    <state></state>
    <since></since>
    <sign></sign>
</ms.request>

Параметры запроса

название назначение примечание
ms.request/@number Номер запроса Целое число в диапазоне от 1 до 263-1 (9 223 372 036 854 775 807). Номер последующего запроса должен быть больше предыдущего.
login Логин Если Вы имеете доступ к киперу, которым ранее авторизовывались на Мегастоке для регистрации интегратора, укажите WMID этого кипера и установите атрибут type="1".
Если Вы работаете через сервис processing.webmoney.com, укажите Ваш логин на Процессинге и установите атрибут type="2".
int_id Номер, под которым интегратор зарегистрирован в Мегастоке Номер можно узнать на странице со списком сайтов, зарегистрированных на WMID интегратора.
int_wmid WMID интегратора WMID, под которым интегратор зарегистрирован в Мегастоке.
startid Номер продавца в каталоге, с которого начинать выборку (результат отсортирован по номеру сайта в каталоге) Пустое поле равносильно startid = 0.
itemscount Количество элементов в выборке Если поле пустое, возвращаются все продавцы, начиная с продавца с номером startid.
state Идентификатор статуса Позволяет отфильтровать только продавцов в заданном статусе. Необязательное поле.
since Дата, с которой начинать выобрку (формат: yyyy-MM-dd HH:mm) Позволяет отфильтровать только тех продавцов, информация о которых изменилась после заданной даты. Необязательное поле.
sign Подпись запроса Для login type="1" строка для подписи создается путем конкатенации параметров: ms.request/@number+login+int_id+int_wmid+startid+itemscount. Подпись формируется с помощью модуля WMSigner.
Для login type="2" строка для подписи создается путем конкатенации параметров: ms.request/@number+login+int_id+int_wmid+startid+itemscount+salt. Значение salt (секретное слово на интерфейсы сервиса processing.webmoney.com) можно узнать у менеджера, через которого Вы заключали договор с Процессингом. Подпись формируется по алгоритму SHA1 (получившийся массив байтов преобразуется в последовательность символов по схеме Base64). В итоге подпись должна представлять собой строку вида 1ZPMat65eA7iQ0ibGFYx1ZxzyKU=.

Формат ответа

<ms.response>
    <retval></retval>
    <retdescr></retdescr>
    <resource>
        <id></id>
        <state id="" stamp=""></state>
        <statecomment></statecomment>
        <url></url>
        <keywords></keywords>
        <group></group>
        <nameincomment></nameincomment>
        <beneficiary type=""></beneficiary>
        <about lang="">
            <name></name>
            <descr></descr>
        </about>
    </resource>
    ...
</ms.response>

Параметры ответа

название назначение примечание
retval Код выполнения запроса 0 – запрос выполнен успешно.
retdescr Расшифровка кода выполнения запроса  
resource Содержит данные о магазине  
resource/state Статус магазина Если магазин в статусе 3 (not activated), в атрибуте state@stamp содержится время перехода в этот статус.
resource/statecomment Причина перевода в текущий статус Присутствует только для статуса 3 (not activated).

Обновление данных о продавце платежного интегратора

URL для передачи запроса – https://megastock.com/xml/int/UpdateMerchant.ashx

Метод – POST

Формат запроса:

<ms.request number="">
    <login type=""></login>
    <int_id></int_id>
    <int_wmid></int_wmid>
    <resourceid></resourceid>

    <beneficiary type="">
        <legalname></legalname>
        <regcountry></regcountry>
        <legalnumber></legalnumber>
        
        или
        
        <wmid></wmid>
    </beneficiary>
    <url></url>
    <group></group>
    <keywords></keywords>
    <logourl></logourl>
    <about lang="">
        <name></name>
        <descr></descr>
    </about>
    <nameincomment></nameincomment>
    <geobindings>
        <country id="RU"></country>
        <country id="UA"></country>
        ...
    </geobindings>
    <sign></sign>
</ms.request>

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

название назначение примечание
ms.request/@number Номер запроса Целое число в диапазоне от 1 до 263-1 (9 223 372 036 854 775 807). Номер последующего запроса должен быть больше предыдущего.
login Логин Если Вы имеете доступ к киперу, которым ранее авторизовывались на Мегастоке для регистрации интегратора, укажите WMID этого кипера и установите атрибут type="1".
Если Вы работаете через сервис processing.webmoney.com, укажите Ваш логин на Процессинге и установите атрибут type="2".
int_id Номер, под которым интегратор зарегистрирован в Мегастоке Номер можно узнать на странице со списком сайтов, зарегистрированных на WMID интегратора.
int_wmid WMID интегратора WMID, под которым интегратор зарегистрирован в Мегастоке.
resourceid Номер продавца в каталоге
sign Подпись запроса Для login type="1" строка для подписи создается путем конкатенации параметров: ms.request/@number+login+int_id+int_wmid+resourceid+url+nameincomment+legalname+legalnumber+wmid+group. Подпись формируется с помошью модуля WMSigner.
Для login type="2" строка для подписи создается путем конкатенации параметров: ms.request/@number+login+int_id+int_wmid+resourceid+url+nameincomment+legalname+legalnumber+wmid+group+salt. Значение salt (секретное слово на интерфейсы сервиса processing.webmoney.com) можно узнать у менеджера, через которого Вы заключали договор с Процессингом. Подпись формируется по алгоритму SHA1 (получившийся массив байтов преобразуется в последовательность символов по схеме Base64). В итоге подпись должна представлять собой строку вида 1ZPMat65eA7iQ0ibGFYx1ZxzyKU=.
Остальные поля являются необязательными: если их значение не изменилось, их можно не указывать. В подпись отсутствующие поля не подмешиваются. Назначение их описано в интерфейсе по добавлению.

Удаление продавца платежного интегратора

URL для передачи запроса – https://megastock.com/xml/int/RemoveMerchant.ashx

Метод – POST

Формат запроса:

<ms.request number="">
    <login type=""></login>
    <int_id></int_id>
    <int_wmid></int_wmid>
    <resourceid></resourceid>
    <sign></sign>
</ms.request>

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

название назначение примечание
ms.request/@number Номер запроса Целое число в диапазоне от 1 до 263-1 (9 223 372 036 854 775 807). Номер последующего запроса должен быть больше предыдущего.
login Логин Если Вы имеете доступ к киперу, которым ранее авторизовывались на Мегастоке для регистрации интегратора, укажите WMID этого кипера и установите атрибут type="1".
Если Вы работаете через сервис processing.webmoney.com, укажите Ваш логин на Процессинге и установите атрибут type="2".
int_id Номер, под которым интегратор зарегистрирован в Мегастоке Номер можно узнать на странице со списком сайтов, зарегистрированных на WMID интегратора.
int_wmid WMID интегратора WMID, под которым интегратор зарегистрирован в Мегастоке.
resourceid Номер продавца в каталоге
sign Подпись запроса Для login type="1" строка для подписи создается путем конкатенации параметров: ms.request/@number+login+int_id+int_wmid+resourceid. Подпись формируется с помощью модуля WMSigner.
Для login type="2" строка для подписи создается путем конкатенации параметров: ms.request/@number+login+int_id+int_wmid+resourceid+salt. Значение salt (секретное слово на интерфейсы сервиса processing.webmoney.com) можно узнать у менеджера, через которого Вы заключали договор с Процессингом. Подпись формируется по алгоритму SHA1 (получившийся массив байтов преобразуется в последовательность символов по схеме Base64). В итоге подпись должна представлять собой строку вида 1ZPMat65eA7iQ0ibGFYx1ZxzyKU=.

Формат ответа:

<ms.response>
    <retval></retval>
    <retdescr></retdescr>
    <resourceid></resourceid>
    <resourcestate></resourcestate>
</ms.response>

Параметры ответа:

название назначение примечание
retval Код выполнения запроса 0 – мерчант удален; остальные коды см. ниже.
retdescr Расшифровка кода выполнения запроса Список кодов см. ниже.
resourceid Номер сайта в каталоге Мегасток Поле заполнено только при retval=0.
resourcestate Статус продавца в каталоге Мегасток Если retval=0, resourcestate принимает значение Removed, в противном случае поле не заполнено.

Коды выполнения запроса

retval retdescr примечание
0 OK Запрос успешно выполнен
-59 already registered Магазин уже зарегистрирован
-62 geobindings are incorrect Неверно указан список стран, в которых работает магазин
-63 merchant name and description are not set properly Значения about/name / about/descr некорректны
-64 nameincomment is incorrect Значение nameincomment некорректно
-65 logo is incorrect Некорректный логотип
-66 error downloading logo Не удалось загрузить логотип
-67 group is incorrect Значение group некорректно
-68 unable to open url Не удалось открыть указанный url
-69 url is incorrect Значение url некорректно
-73 phone is incorrect Значение beneficiary/phone некорректно
-74 email is incorrect Значение beneficiary/email некорректно
-75 taxpayernumber is incorrect Значение beneficiary/taxpayernumber некорректно
-76 legalnumber is incorrect Значение beneficiary/legalnumber некорректно
-77 unknown regcountry Значение beneficiary/regcountry некорректно
-78 legalname is incorrect Значение beneficiary/legalname некорректно
-79 beneficiary is incorrect Значение beneficiary/wmid некорректно
-85 resourceid does not exist Магазина с номером resourceid не существует у указанного в запросе интегратора
-86 Integrator not found Указанный интегратор не найден
-88 int_wmid is incorrect Значение int_wmid некорректно
-89 login is incorrect Значение login некорректно
-97 Request number is incorrect Неверное значение ms.request/@number
-98 Signature is incorrect Подпись неверна
-99 Error processing request Общая ошибка разбора запроса
-100 Request is empty Пустой запрос

Перечень возможных статусов продавца в каталоге

ID статуса Название статуса Описание
0 New application Заявка на добавление продавца принята, но еще не обработана модератором.
1 In catalog Сайт в каталоге.
3 Not activated Заявка отклонена (или сайт временно исключен из каталога) до устранения замечаний модератора. Как только замечания устранены, можно подать заявку на обновление.
4 Removed Сайт удален. Восстановление через интерфейс обновления невозможно.
5 Hidden Сайт зарегистрирован, но на страницах каталога не показывается. Никаких других ограничений по сравнению со статусом "1 - In Catalog" нет.
H