Registration

Interfaces for Payment Integrators


Adding Payment Integrator's merchant

<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>
		or
		<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>
  • request parameters:
title purpose comment
ms.request/@number Request number Integer between 1 and 263-1 (9 223 372 036 854 775 807). Must be greater than the previous request number.
login Login If you have access to the keeper, used to log in to the MegaStock during the integrator registration, specify this WMID and set the attribute type="1".
If you use processing.webmoney.ru service, specify your Processing login and set the attribute type="2".
int_id Integrator registration number This number can be found here (Website ID of the integrator).
int_wmid Integrator WMID Integrator WMID, registered in MegaStock catalogue.
beneficiary Recipient If you make payments to the merchant under the agreement, set the attribute type="1".
If you make payments in WebMoney, set the attribute type="2".
beneficiary/legalname Legal name of the recipient Only for beneficiary type="1".
beneficiary/regcountry Company registration country Alpha-2 country code. Only for beneficiary type="1".
beneficiary/legalnumber State Registration Number Only for beneficiary type="1".
beneficiary/taxpayernumber Taxpayer Number Only for beneficiary type="1".
beneficiary/email Merchant's e-mail Only for beneficiary type="1".
beneficiary/phone Merchant's phone number Only for beneficiary type="1".
beneficiary/wmid Merchant's WMID Only for beneficiary type="2". The recipient should have the Personal passport or higher.
url Merchant website URL URL should be specified together with the protocol (http or https). E.g., http://www.publicant.ru.
group ID of the category of goods/services The list of MegaStock categories and their IDs is available here.
keywords Keywords and phrases for searching the merchant in the catalogue Separate keywords with commas.
logourl The link to the merchant logo file The logo should be sized 88x31 pixel and should not exceed 10Kb.
This field can be left blank.
about This element contains the description of the merchant's goods If the goods/services are intended for the Russian-speaking audience, lang="ru".
If the goods/services are intended for the English-speaking audience, lang="en".
It is allowed to add two elements <about> in different languages.
about\name Merchant trade name No more than 50 characters.
about\descr Goods/services description  
nameincomment The merchant name in the comment to the WM-transaction Example: "Payment for Skype, order 12345678" (where Skype is the merchant name in the comment).
Please keep in mind that the merchant names should not be substrings of each other. For example if you have registered the merchant with nameincomment=Skype, then you won't be able to register another merchant with nameincomment=Skype1.
geobindings This element contains the list of the countries, where the merchant sells goods/provides services If there are no territorial restrictions, this element can be left blank.
sign Request signature For login type="1" the string to sign is the concatenation of the parameters: ms.request/@number+login+int_id+int_wmid+url+nameincomment+group. The string must be signed using WMSigner module.
For login type="2" the string to sign is the concatenation of the parameters: ms.request/@number+login+int_id+int_wmid+url+nameincomment+group+salt. You can find out the "salt" (secret word for Processing interfaces) value from the manager, who was assisting you when concluding the Processing agreement. The string must be signed using SHA1 algorithm (the resulting byte array is converted into a sequence of characters according to Base64 scheme). Eventually the signature should look like this: 1ZPMat65eA7iQ0ibGFYx1ZxzyKU=.
  • response format:
<ms.response>
	<retval></retval>
	<retdescr></retdescr>
	<resourceid></resourceid>
</ms.response>
  • response parameters:
title purpose comment
retval Result code 0 – success.
retdescr Result code description  
resourceid Merchant registration number (LMI_SHOP_ID) in MegaStock catalogue The field is filled in for retval=0.

Getting registered merchants list

<ms.request number="">
	<login type=""></login>
	<int_id></int_id>
	<int_wmid></int_wmid>
	<startid></startid>
	<itemscount></itemscount>
	<sign></sign>
</ms.request>
  • request parameters:
title purpose comment
ms.request/@number Request number Integer between 1 and 263-1 (9 223 372 036 854 775 807). Must be greater than the previous request number.
login Login If you have access to the keeper, used to log in to the MegaStock during the integrator registration, specify this WMID and set the attribute type="1".
If you use processing.webmoney.ru service, specify your Processing login and set the attribute type="2".
int_id Integrator registration number This number can be found here (Website ID of the integrator).
int_wmid Integrator WMID Integrator WMID, registered in MegaStock catalogue.
startid Merchant's registration number (LMI_SHOP_ID) to begin the selection with (the result is sorted by registration number) Empty value is equivalent to startid = 0.
itemscount Number of elements in the selection If the value is empty, the selection contains all the merchants starting with the one with startid identifier.
sign Request signature For login type="1" the string to sign is the concatenation of the parameters: ms.request/@number+login+int_id+int_wmid+startid+itemscount. The string must be signed using WMSigner module.
For login type="2" the string to sign is the concatenation of the parameters: ms.request/@number+login+int_id+int_wmid+startid+itemscount+salt. You can find out the "salt" (secret word for Processing interfaces) value from the manager, who was assisting you when concluding the Processing agreement. The string must be signed using SHA1 algorithm (the resulting byte array is converted into a sequence of characters according to Base64 scheme). Eventually the signature should look like this: 1ZPMat65eA7iQ0ibGFYx1ZxzyKU=.
  • response format:
<ms.response>
  <retval></retval>
  <retdescr></retdescr>
  <resource>
    <id></id>
    <state id=""></state>
    <url></url>
    <keywords></keywords>
    <group></group>
    <nameincomment></nameincomment>
    <beneficiary type=""></beneficiary>
    <about lang="">
      <name></name>
      <descr></descr>
    </about>
  </resource>
  ...
</ms.response>

Updating merchant

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

	<beneficiary type="">
		<legalname></legalname>
		<regcountry></regcountry>
		<legalnumber></legalnumber>
		or
		<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>
  • request parameters:
title purpose comment
ms.request/@number Request number Integer between 1 and 263-1 (9 223 372 036 854 775 807). Must be greater than the previous request number.
login Login If you have access to the keeper, used to log in to the MegaStock during the integrator registration, specify this WMID and set the attribute type="1".
If you use processing.webmoney.ru service, specify your Processing login and set the attribute type="2".
int_id Integrator registration number This number can be found here (Website ID of the integrator).
int_wmid Integrator WMID Integrator WMID, registered in MegaStock catalogue.
resourceid Merchant Id
sign Request signature For login type="1" the string to sign is the concatenation of the parameters: ms.request/@number+login+int_id+int_wmid+resourceid+url+nameincomment+legalname+legalnumber+wmid+group. The string must be signed using WMSigner module.
For login type="2" the string to sign is the concatenation of the parameters: ms.request/@number+login+int_id+int_wmid+resourceid+url+nameincomment+legalname+legalnumber+wmid+group+salt. You can find out the "salt" (secret word for Processing interfaces) value from the manager, who was assisting you when concluding the Processing agreement. The string must be signed using SHA1 algorithm (the resulting byte array is converted into a sequence of characters according to Base64 scheme). Eventually the signature should look like this: 1ZPMat65eA7iQ0ibGFYx1ZxzyKU=.
The rest fields are optional: if the value has not been changed, the field can be skipped. The skipped fields are not included into the signature. The purpose of this fields is described in the interface for adding.

Removing merchant

<ms.request number="">
	<login type=""></login>
	<int_id></int_id>
	<int_wmid></int_wmid>
	<resourceid></resourceid>
	<sign></sign>
</ms.request>
  • request parameters:
title purpose comment
ms.request/@number Request number Integer between 1 and 263-1 (9 223 372 036 854 775 807). Must be greater than the previous request number.
login Login If you have access to the keeper, used to log in to the MegaStock during the integrator registration, specify this WMID and set the attribute type="1".
If you use processing.webmoney.ru service, specify your Processing login and set the attribute type="2".
int_id Integrator registration number This number can be found here (Website ID of the integrator).
int_wmid Integrator WMID Integrator WMID, registered in MegaStock catalogue.
resourceid Merchant Id to remove
sign Request signature For login type="1" the string to sign is the concatenation of the parameters: ms.request/@number+login+int_id+int_wmid+resourceid. The string must be signed using WMSigner module.
For login type="2" the string to sign is the concatenation of the parameters: ms.request/@number+login+int_id+int_wmid+resourceid+salt. You can find out the "salt" (secret word for Processing interfaces) value from the manager, who was assisting you when concluding the Processing agreement. The string must be signed using SHA1 algorithm (the resulting byte array is converted into a sequence of characters according to Base64 scheme). Eventually the signature should look like this: 1ZPMat65eA7iQ0ibGFYx1ZxzyKU=.
  • response format:
<ms.response>
	<retval></retval>
	<retdescr></retdescr>
	<resourceid></resourceid>
	<resourcestate></resourcestate>
</ms.response>
  • response parameters:
title purpose comment
retval Result code 0 – merchant removed.
retdescr Result code description  
resourceid Merchant registration number (LMI_SHOP_ID) in MegaStock catalogue The field is filled in for retval=0.
resourcestate Merchant status The field is filled in for retval=0.

List of possible Merchant statuses in catalogue

Status IDStatus NameDescription
0New applicationThe application is accepted, but is not processed by the Moderator yet.
1In catalogWebsite is in catalogue.
3Not activatedApplication is rejected (or website is temporarily excluded from catalogue) until the elimination of Moderator’s comments. Once the comments are eliminated, it is possible to apply for update.
4RemovedWebsite is removed. Restoring through the update interface is impossible.
5HiddenWebsite is registered, but is not shown on catalogue pages. There is no other restrictions in comparison with the status "1 - In Catalog".