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


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

<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.ru, укажите Ваш логин на Процессинге и установите атрибут 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). Например, http://www.publicant.ru.
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.ru) можно узнать у менеджера, через которого Вы заключали договор с Процессингом. Подпись формируется по алгоритму 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.

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

<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.ru, укажите Ваш логин на Процессинге и установите атрибут 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.ru) можно узнать у менеджера, через которого Вы заключали договор с Процессингом. Подпись формируется по алгоритму 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).

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

<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.ru, укажите Ваш логин на Процессинге и установите атрибут 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.ru) можно узнать у менеджера, через которого Вы заключали договор с Процессингом. Подпись формируется по алгоритму SHA1 (получившийся массив байтов преобразуется в последовательность символов по схеме Base64). В итоге подпись должна представлять собой строку вида 1ZPMat65eA7iQ0ibGFYx1ZxzyKU=.
Остальные поля являются необязательными: если их значение не изменилось, их можно не указывать. В подпись отсутствующие поля не подмешиваются. Назначение их описано в интерфейсе по добавлению.

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

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