WebMoney

Wiki

Интерфейс импорта данных сервиса Geo WebMoney

Данный интерфейс позволяет производить автоматическую загрузку на сервер WebMoney GeoService списка пользовательских WM-объектов определенного типа.

Формат файла XML для сервиса:

Ниже приведен пример, описывающий один пользовательский объект (обменный пункт)

<?xml version="1.0" encoding="windows-1251"?>
<wmobjects>
 <row 
  sid="34" 
  citid="12918" 
  name="Обменный пункт WM-USD (через банковскую ячейку)" 
  wmid="254923317046" 
  web="http://www.wmcasher.com" 
  email="cash@wmcasher.com" 
  type="1" 
  addr="ул. Орджоникидзе д.9 корп.2" 
  worktime="Понедельник - пятница, с 11:00 до 17:00" 
  phone="(смотрите на сайте)" 
  mid="69" 
  mid2="158" 
  dopinfo="Обмен WM на наличные USD и наоборот через банковскую ячейку. Ввод - 0%, вывод - 2%" 
  help="http://www.wmcasher.com/contact.asp" 
  lng="37.5998" 
  lat="55.70924" 
  direction="3" 
  lang="ru-RU" 
  />
</wmobjects>

Требования к файлу:

  • Файл должен начинаться открывающим тэгом <wmobjects> и заканчиваться тэгом </wmobjects>
  • Содержать хотя бы один тег <row/> - строка, содержащая данные об одном объекте
  • Файл должен быть сохранен в кодировке windows-1251
  • Все объекты должны быть географически привязаны к базе данных WebMoney GeoService, т.е. каждому объекту должен быть сопоставлен уникальный номер (ID) населенного пункта, в котором он расположен. Как получить список стран, регионов и городов, читайте ниже по тексту.
  • Ко всем данным должно применяться маскирование запрещенных символов:
  1. Двойные кавычки «"» должны быть замены на &quot;
  2. Знак Больше «>» должен быть заменен на &gt;
  3. Знак Меньше «<» должен быть заменен на &lt;
Название атрибута XML        Обязательный Описание параметра
wmobjects/row/@sid Обязательный Уникальный номер точки или уникальный идентификатор автомата, банкомата или терминала (kiosk_id).
wmobjects/row/@citid Обязательный Номер (ID) города, в котором расположен объект. ID городов можно найти здесь
wmobjects/row/@name Обязательный Название объекта
wmobjects/row/@type Обязательный Тип объекта (6 - точки продажи WM карт, 7 - точки пополнения наличными, остальные необходимо согласовать с администратором сервиса ()
wmobjects/row/@lang Обязательный Язык (CultureInfo)
wmobjects/row/@direction Обязательный Тип услуги (1-ввод, 2-вывод, 3-ввод/вывод)
wmobjects/row/@country Необязательный Страна
wmobjects/row/@region Необязательный Регион
wmobjects/row/@city Необязательный Город
wmobjects/row/@wmid Необязательный WM - идентификатор
wmobjects/row/@web Необязательный URL сайта
wmobjects/row/@email Необязательный E-mail
wmobjects/row/@mid Обязательный для объектов в Москве и Санкт-Петербурге Номер (ID) ближайшей станции метро (1). Только для Москвы и Санкт-Петербурга
ID станций метро можно найти здесь
wmobjects/row/@mid2 Необязательный Номер (ID) ближайшей станции метро (2). Только для Москвы и Санкт-Петербурга
ID станций метро можно найти здесь
wmobjects/row/@dopinfo Необязательный Дополнительная информация
wmobjects/row/@phone Необязательный Номер контактного телефона
wmobjects/row/@addr Необязательный Адрес
wmobjects/row/@worktime Необязательный Рабочие часы
wmobjects/row/@tarif Необязательный Тариф
wmobjects/row/@proezd Необязательный Схема проезда (URL)
wmobjects/row/@srok Необязательный Срок пополнения
wmobjects/row/@help Необязательный Инструкция (URL)
wmobjects/row/@lng Необязательный Долгота (Longitude)
wmobjects/row/@lat Необязательный Широта (Latitude)

Каждый пакет XML не должен превышать 200 (максимальное число строк) строк в одном наборе данных. Для обновления данных, где количество строк больше чем 200, сервис обновления сайта вызывает зарегистрированный URL несколько раз, с различными параметрами FirstId, который указывает на максимальный SID предыдущего набора данных. Для корректной работы системы обновления в каждом пакете данных (оптимально использовать не более 200 строк) необходимо указывать тег LastID. LastID - это максимальный SID (идентификатор точки) в одном наборе данных.

Формат описан ниже:


    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 или -1, данные кончились) 

Название тега XML        Обязательный Описание параметра
wmobjects/lastid/@value Обязательный, если общий объем данных превышает количество 200 строк Идентификатор последней записи в наборе данных

Пример для банков и платежных систем, принимающих наличные рубли для пополнения R-кошельков системы WebMoney Transfer:

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

    <row 
    sid="1000" 
    citid="12918" 
    name="Платежный терминал X-System" 
    web="http://www.x-system.ru/" 
    email="support@x-system.ru" 
    mid="117" 
    addr="ул. Квесисская, д. 28, стр. 11." 
    srok="мгновенно" 
    tarif="2.5% от суммы платежа" 
    worktime="круглосуточно" 
    help="http://www.webmoney.ru/wmintrans6.shtml" 
    dopinfo="Пополнение R кошелька наличными рублями" 
    direction="1" 
    type="7"/>

    <row 
    sid="1001" 
    citid="28610" 
    name="Платежный терминал X-System"  
    web="http://www.x-system.ru/"  
    email="support@x-system.ru" 
    mid="1001" 
    addr="ул. Коллонтай, д. 23, стр. 2." 
    srok="мгновенно" 
    tarif="2.5% от суммы платежа" 
    worktime="круглосуточно" 
    help="http://www.webmoney.ru/wmintrans6.shtml" 
    dopinfo="Пополнение R кошелька наличными рублями"  
    direction="1" 
    type="7"/>

        .
        .
        .

    <row 
    sid="1200" 
    citid="12918" 
    name="Платежный терминал X-System" 
    web="http://www.x-system.ru/" 
    email="support@x-system.ru" 
    mid="13" 
    addr="ул. Римского-Корсакова, д. 22" 
    srok="с 9-00 до 22-00" 
    tarif="2.5% от суммы платежа" 
    worktime="круглосуточно" 
    help="http://www.webmoney.ru/wmintrans6.shtml" 
    dopinfo="Пополнение R кошелька наличными рублями"  
    direction="1" 
    type="7"/>

        <lastid value="-1" />
        <!-- конец данных -->

</wmobjects>