WebMoney

Wiki

Geo service interfaces

GEOWM.INPUTXML Service

This interface allows automatic uploading to WebMoney GeoService server the list of user WM-objects of certain type.

XML file format for GEOWM.INPUTXML service:

The example below describes one user object (exchange agency):

<?xml version="1.0" encoding="windows-1251"?>
<wmobjects>
 <row 
  sid="30482" 
  citid="12918" 
  name="Association &quot;WMEXPRESS&quot; in Moscow" 
  wmid="477230148314" 
  web="http://wmmoscow.com/" 
  email="" 
  type="1" 
  addr="17 Bolshaya Ordynka" 
  worktime="Monday - Friday, from 10:30 till 19:00" 
  phone="(901)530xxx1, (901)530xxx2" 
  mid="16" 
  mid2="0" 
  dopinfo="exchanging WM*, EGOLD, Yandex.Money. Adding and withdrawing WebMoney in Moscow. Cashless adding and withdrawing WebMoney and E-Gold" 
  help="" 
  lng="" 
  lat="" 
  direction="3" 
  lang="ru-RU" 
  />
</wmobjects>

Requirements to GEOWM.INPUTXML file:

  • The file must begin with <wmobjects> opening tag and end with the </wmobjects> tag.
  • One <row/> tag is a string containing data about one object.
  • The file must be saved in windows-1251 encoding.
  • All objects must be geographically binded to WebMoney GeoService geodata database, i.e. each object must have a unique number (ID) of the place (city) where it is located.
  • The following masking must be applied to all unallowed symbols: # Double quotes <"> must be replaced with &quot; # Greater than sign ">" must be replaced with &gt; # Less than sign "<" must be replaced with &lt;
Attribute name XML        Mandatory Parameter description
wmobjects/row/@sid Mandatory Unique number of the location or unique identifier of ATM (kiosk_id).
wmobjects/row/@citid Mandatory City number (ID), where the object is located. You can find the list of city IDs here
wmobjects/row/@name Mandatory Object name
wmobjects/row/@type Mandatory Object type (6 - WM cards selling points, 7 - points for adding funds by depositing cash, other must be conformed with the service administrator ()
wmobjects/row/@lang Mandatory Language (CultureInfo)
wmobjects/row/@direction Mandatory Type of service (1-adding, 2-withdrawing, 3-adding/withdrawing)
wmobjects/row/@country Optional Country
wmobjects/row/@region Optional Region
wmobjects/row/@city Optional City
wmobjects/row/@wmid Optional WM-identifier
wmobjects/row/@web Optional Web-site URL
wmobjects/row/@email Optional E-mail
wmobjects/row/@mid Mandatory for objects located in Moscow and St. Petersbourgh Number (ID) of the closest metro station (1). Only for Moscow and St. Petersbourgh
You can find the list of metro stations IDs here
wmobjects/row/@mid2 Optional Number (ID) of the closest metro station (2). Only for Moscow and St. Petersbourgh
You can find the list of metro stations IDs here
wmobjects/row/@dopinfo Optional Additional information
wmobjects/row/@phone Optional Contact phone number
wmobjects/row/@addr Optional Address
wmobjects/row/@worktime Optional Working hours
wmobjects/row/@tarif Optional Rates
wmobjects/row/@proezd Optional Location map (URL)
wmobjects/row/@srok Optional Adding term
wmobjects/row/@help Optional Instructions (URL)
wmobjects/row/@lng Optional Longitude
wmobjects/row/@lat Optional Latitude

Each XML batch must not exceed 200 (maximum) strings in one data set. To update the data, having greater number of strings in one set, the web-site update service calls the registered URL several times, with different FirstId parameters, specifying maximum SID of the previous data set. For correct operation of the update system, each data set batch (200 strings) must have LastID specified. LastId is the ID of the last string in one data set.

Its format is described below:


    http://yoursite.com/yourservice/dataxml?fisrtid=0 (lastid=200)
    http://yoursite.com/yourservice/dataxml?fisrtid=200 (lastid=400)
    http://yoursite.com/yourservice/dataxml?fisrtid=400 (lastid=600)
    .
    .
    .
    http://yoursite.com/yourservice/dataxml?fisrtid=1000 (lastid=1200)
    http://yoursite.com/yourservice/dataxml?fisrtid=1200 (lastid=1200 not greater than 1200 or -1, data is out of range) 

Attribute name XML        Mandatory Parameter description
wmobjects/lastid/@value Mandatory, if the total volume of data exceeds 200 strings ID of the last record in the data set

A sample of GEOWM.INPUTXML for banks and payment systems, accepting rubles in cash for depositing to R-purses in WebMoney Transfer:

<?xml version="1.0" encoding="windows-1251"?>
<wmobjects>

    <row 
    sid="1000" 
    citid="12918" 
    name="X-System payment terminal" 
    web="http://www.x-system.ru/" 
    email="support@x-system.ru" 
    mid="117" 
    addr="11-28 Kvesisskaya str." 
    srok="immediately" 
    tarif="2.5% from transaction sum" 
    worktime="24 hours" 
    help="http://www.webmoney.ru/wmintrans6.shtml" 
    dopinfo="Adding funds to R-purse by depositing cash" 
    direction="1" 
    type="7"/>

    <row 
    sid="1001" 
    citid="28610" 
    name="X-System payment terminal"  
    web="http://www.x-system.ru/"  
    email="support@x-system.ru" 
    mid="1001" 
    addr="2-23 Kolontai str" 
    srok="immediately" 
    tarif="2.5% from transaction sum" 
    worktime="24 hours" 
    help="http://www.webmoney.ru/wmintrans6.shtml" 
    dopinfo="Adding funds to R-purse by depositing cash"  
    direction="1" 
    type="7"/>

        .
        .
        .

    <row 
    sid="1200" 
    citid="12918" 
    name="X-System payment terminal" 
    web="http://www.x-system.ru/" 
    email="support@x-system.ru" 
    mid="13" 
    addr="22, Rimsky-Korsakov str" 
    srok="from 9-00 till 22-00" 
    tarif="2.5% from transaction sum" 
    worktime="24 hours" 
    help="http://www.webmoney.ru/wmintrans6.shtml" 
    dopinfo="Adding funds to R-purse by depositing cash"  
    direction="1" 
    type="7"/>

        <lastid value="-1" />
        <!-- end of data -->

</wmobjects>

GEOWM.OUTPUTXML web-service

This interface allows retrieving from geodata database:
  • List of countries
  • List of regions (for a specific country)
  • City list (for a specific region)
  • List of metro stations (for Moscow and St. Petersbourgh)

Web-service URL and available methods:

https://geo.webmoney.ru/find/GeoSearchService.asmx

Main methods

  • GetCountryList
    Returns the list of countries
  • GetRegionList
    Returns the list of regions. Counry ID is set.
  • GetCityList
    Returns the list of cities and towns. Region ID is set. If hasCoords=1 geographical coordinates are returned, if hasCoords=0 - then not.
  • GetNearestMetro
    Returns the list of metro stations, sorted by remoteness from the specified coordinates. Geo-coordinates are set.
  • GetNearestMetro2
    Returns the list of metro stations, sorted by remoteness from the address. City ID and address are specified.
  • GetNearestMetro3
    Returns the list of metro stations, sorted by remoteness from the address. City ID and address are specified. The city is set as a string, not as ID.

Additional methods

  • AddressGeoCoding
    Geocodes the address, by processing it with the ParseAddress method in advance. Returns geographical coordinates. It is similar to GeoCoding, but it is advised to user AddressGeoCoding, if the address is not structured.
  • AddressGeoCoding2
    Geocodes the address, by processing it with the ParseAddress method in advance. Returns geographical coordinates. It is similar to GeoCoding, but it is advised to user AddressGeoCoding, if the address is not structured.
  • AddressGeoCodingY
    Geocodes the address, by processing it with Yandex geocoder. Returns geographical coordinates. Address contains structured address.
  • AddressGeoCodingY2
    Geocodes the address, by processing it with Yandex geocoder. Returns geographical coordinates. Address contains structured address. City is set as a string, and not as ID
  • AddressParsingY
    Structures the address with Yandex geocoder. Returns structured address.
  • AddressParsingY2
    Structures the address with Yandex geocoder. Returns structured address. The city is specified as a string, not as ID.

In order to user the service, the user must go through the registration procedure. After the registration process you will GUID (unique user's identifier) and password. Each method of this web-service accepts two additional parameters - GUID and password.

You can find more detailed information on this page offering help for a user of this interface.

GEOWM-Locator search interface

This interface allows making geographical binding of any resources (offices and subsidiaries, objects of storage or agent network, etc), i.e. everything that can be later displayed on a map. The main task of this interface is provide access to unique for WebMoney Transfer system geodata database, and by using which it is possible to display "geographically binded" objects by means of WebMoney GeoService without earlier processing.

You can find more detailed information on page with help services of this service.