Интерфейс X16

Интерфейс X16. Создание кошелька.

Этот интерфейс доступен только зарегистрированным клиентам. Для регистрации перешлите по внутренней почте на WMID 941977853154 (Техническая поддержка) краткую информацию о проекте, URL сайта, IP-адрес с которого будут отсылаться запросы, цель и способ использования интерфейса. Кипер подписывающий запросы должен иметь персональный аттестат (запросы обрабатываются до 3х раб. дней).

Интерфейс позволяет создать новый кошелек с заданным типом и названием.

<w3s.request>
  <reqn></reqn>
	<wmid></wmid>
	<sign>createpurse/wmid+createpurse/pursetype+reqn</sign>
	<createpurse>
		<wmid></wmid>
		<pursetype></pursetype>
		<desc></desc>
	</createpurse>
</w3s.request>
  • параметры запроса:
название назначение примечание
reqn номер запроса целое без знака, макс. количество цифр – 15; всегда должен быть больше номера предыдущего запроса
wmid WMID подписавшего запрос используется только при авторизации с ключами WM Keeper Classic
sign подпись запроса формируется из параметров: createpurse/wmid+createpurse/pursetype+reqn используется только при авторизации с ключами WM Keeper Classic
createpurse параметры создаваемого кошелька
createpurse\wmid WMID кошелька ВМ-идентификатор, которому будет принадлежать вновь созданный кошелек. Фактически данный ВМ-идентификатор должен быть равен идентификатору передаваемому в теге wmid идентификатора подписывающего запрос, так как кошелек может быть создан только у идентификатора подписывающего запрос, работа с интерфейсом по доверию невозможна.
createpurse\pursetype тип кошелька Тип создаваемого кошелька в виде одного латинского символа в верхнем регистре B ,C ,D ,E ,G ,R ,U ,Y ,Z.
createpurse\desc название кошелька текстовое название кошелька, которое будет отображаться в интерфейсе Webmoney Keeper Classic или Light.
  • формат ответа:
<w3s.response>
  <reqn></reqn>
	<retval></retval>
	<retdesc></retdesc>
	<purse id="n">
		<pursename></pursename>
		<amount></amount>
		<desc></desc>
	</purse>
</w3s.response>
  • параметры ответа:
название назначение примечание
reqn номер запроса
retval код выполнения 0 – запрос выполнен успешно, интерфейс возвращает те же коды ошибок, что и Интерфейс X2, за исключением специфичных для интерфейса ошибок, перечисленных ниже
retdesc расшифровка кода выполнения
purse параметры созданного кошелька атрибут id – уникальный номер кошелька в системе учета WebMoney
purse\pursename номер кошелька
purse\amount сумма на кошельке
purse\desc название кошелька
  • специфичные для интерфейса ошибки (retval):
код описание
15 внутренняя ошибка создания кошелька
31 кошелек указанного типа может быть только один
44 в создании кошелька данного типа данному ВМ-идентификатору отказано
1007 слишком много кошельков внутри одного ВМИД, текущее ограничение – 1000 кошельков внутри одного ВМИД

см. также XML-интерфейсы

Категория: XML-интерфейсы

This article in other languages: English