API for Payment Service Providers

Adding Payment Integrator's merchant

Requests should be sent to https://megastock.com/xml/int/AddMerchant.ashx

Method – POST

Request format

<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.com 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 catalog.
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., https://top-up.webmoney.com.
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 English-speaking audience, lang="en".
If the goods/services are intended for the Russian-speaking audience, lang="ru".
It is allowed to add two elements <about> in different languages.
about\name Merchant trade name Up to 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.

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 catalog The field is filled in for retval=0.

Getting registered merchants list

Requests should be sent to https://megastock.com/xml/int/GetMerchants.ashx

Method – POST

Request format

<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>

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.com 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 equal 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="" 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>

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

Title Purpose Comment
retval Result code 0 – success.
retdescr Result code description  
resource Contains merchant data  
resource/state Merchant status  
resource/statecomment Reason for moving to current state Only for status 3 (not activated).

Updating merchant

Requests should be sent to https://megastock.com/xml/int/UpdateMerchant.ashx

Method – POST

Request format

<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>

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.com 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 catalog.
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

Requests should be sent to https://megastock.com/xml/int/RemoveMerchant.ashx

Method – POST

Request format

<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.com 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 catalog.
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 catalog The field is filled in for retval=0.
resourcestate Merchant status The field is filled in for retval=0.

Execution codes (retval values)

retval retdescr comment
0 OK Success
-59 already registered
-62 geobindings are incorrect The list of countries is incorrect
-63 merchant name and description are not set properly Check about/name / about/descr values
-64 nameincomment is incorrect
-65 logo is incorrect
-66 error downloading logo
-67 group is incorrect
-68 unable to open url
-69 url is incorrect
-73 phone is incorrect Check beneficiary/phone value
-74 email is incorrect Check beneficiary/email value
-75 taxpayernumber is incorrect Check beneficiary/taxpayernumber value
-76 legalnumber is incorrect Check beneficiary/legalnumber value
-77 unknown regcountry Check beneficiary/regcountry value
-78 legalname is incorrect Check beneficiary/legalname value
-79 beneficiary is incorrect Check beneficiary/wmid value
-85 resourceid does not exist PSP does not contain merchant with such resourceid
-86 Integrator not found
-88 int_wmid is incorrect Check int_wmid value
-89 login is incorrect Check login value
-97 Request number is incorrect
-98 Signature is incorrect
-99 Error processing request
-100 Request is empty

List of possible Merchant's statuses

Status ID Status Name Description
0 New application The application is accepted, but is not processed by the Moderator yet.
1 In catalog Website is in catalog.
3 Not activated Application is rejected (or website is temporarily excluded from catalog) until the elimination of Moderator’s comments. Once the comments are eliminated, it is possible to apply for update.
4 Removed Website is removed. Restoring through the update interface is impossible.
5 Hidden Website is registered, but is not shown on catalog pages. There is no other restrictions in comparison with the status "1 - In Catalog".
H