Wiki

Постановка новой заявки на обмен

В секции реализован XML-интерфейс для автоматической постановки на обмен новой заявки.

  • формат запроса:
<?xml version=\"1.0\"?>
<wm.exchanger.request>    
    <wmid></wmid>
    <signstr></signstr>
    <inpurse></inpurse>
    <outpurse></outpurse>    
    <inamount></inamount>    
    <outamount></outamount>    
    <capitallerwmid></capitallerwmid>    
</wm.exchanger.request>
  • параметры запроса:
    название назначение примечание
    wmid WMID подписавшего запрос 12 цифр - WMID, с которого будет выставляться новая заявка
    signstr подпись запроса 132-символьная цифровая подпись (ключами .kwm идентификатора wmid) значений 5-ти тэгов запроса склеенных в одну строку без пробелов "wmid + inpurse + outpurse + inamount + outamount" (формирование цифровой подписи см. в описании общих WM-интерфейсов для разработчиков)
    inpurse номер отдающего кошелька номер кошелька идентификатора wmid, с которого необходимо взять сумму к обмену для постановки заявки, на данный кошелек должно быть установлено доверие на выполнение переводов от имени идентификатора сервиса системы WMT - WMID#128984249415 - секции wm.exchanger. Обратите внимание, что для выставления заявки с указанным тегом capitallerwmid это доверие устанавливается управляющим капиталлера в разделе Интеграция сайта capitaller.ru
    outpurse номер принимающего кошелька номер кошелька идентификатора wmid, на который будут поступать средства по мере обмена
    inamount сумма обмена сумма, которая будет автоматически переведена с кошелька inpurse на кошелек сервиса секции wm.exchanger и выставлена к обмену
    outamount обменянная сумм сумма, которую необходимо перевести на кошелек outpurse по завершению обмена, если в данном поле указать сумму, равную 0.0, то заявка будет выставлена через БЫСТРЫЙ ОБМЕН, то есть сразу же после постановки этой заявки с нее будет полностью выкуплена очередь самых выгодных из противоположных к ней по направлению
    capitallerwmid wmid капиталлера необязательно поле, если в данном поле передать WMID капиталлера (www.capitaller.ru), то данным запросом может быть поставлена на обмен заявка от имени capitallerwmid. При этом у идентификатора wmid, осуществляющего подпись запроса, должен быть доступ, описанный на странице имперсонализации капиталлера.
  • формат ответа:
<?xml version=\"1.0\"?>
<wm.exchanger.response>
    <retval operid="" wmtransid=""></retval>
    <retdesc></retdesc>
    <capitallerwmid></capitallerwmid>
</wm.exchanger.response>
  • параметры ответа:
    название назначение примечание
    retval код выполнения 0 - в случае успешного выполнения операции, цифровое обозначение ошибки в противном случае. При успешном результате в атрибутах тэга retval находятся номер поставленной заявки (атрибут operid) и номер транзакции в WMT (атрибут wmtransid).
    retdesc расшифровка кода выполнения если retval не равен 0
  • значения retdesc:
    код описание
    -10 Идентификатор клиента не указан
    -11 Ошибка при указании подписи, тег signstr
    -14 Подпись не прошла &ClientPlanStr& (возвращается строка, которая должна была быть подписана)
    -15 Ошибка загрузки XML c параметрами запроса
    -20 Обмен для данного типа кошелька на бирже недоступен.
    -21 Ошибка при указании кошелька с которого производится списание - он должен быть указан и состоять из буквы и 12 цифр.
    -22 Ошибка при указании кошелька на который производится получение - он должен быть указан и состоять из буквы и 12 цифр.
    -23 Ошибка при указании суммы, которую Вы будете обменивать. Она должна содержать только цифры и знак разделителя без пробелов и посторонних символов, должна быть обязательно указана и не должна превышать 10 символов.
    -24 Ошибка при указании суммы, которую Вы хотите получить. Она должна содержать только цифры и знак разделителя без пробелов и посторонних символов, должна быть обязательно указана и не должна превышать 10 символов.
    -25 Указанный Вами для списания средств кошелек &CStr(ReqPurse)& не принадлежит Вашему идентификатору &clientwmid&, либо имеет ограничения гаранта (WMB - начальный и выше аттестат, WME - http://urla.ru/7V ).
    -26 Указанный Вами для получения средств кошелек &CStr(ReqPurseOut)& не принадлежит Вашему идентификатору &clientwmid&, либо имеет ограничения гаранта (WMB - начальный и выше аттестат, WME - http://urla.ru/7V ).
    -27 Указанный Вами для получения средств кошелек &CStr(ReqPurseOut)& не принадлежит Вашему идентификатору &clientwmid&
    -60 Ошибка перевода средств с кошелька пользователя на кошелек биржи, либо недостаточно средств на кошельке пользователя, либо отсутствует доверие с кошелька пользователя WMID биржи на требуемую сумму.
    -40 Еще не прошло 5 минут после постановки Вами заявки с данной суммой, подождите 5 минут или измените сумму заявки минимум на 0.01
    2 Кошелек, который Вы указали для получения средств - указан неверно, он не соответствует типу обмена.
    3 Сумма, которую Вы хотите обменять слишком мала, укажите сумму большую или равную "указывается значение"
    4 Сумма, которую Вы хотите получить после обмена слишком мала, укажите сумму большую или равную "указывается значение"
    5 Выбранный Вами курс очень сильно отличается от среднего курса, обмен по данному курсу на бирже невозможен.
    6 У Вас уже есть 5 или более заявок данного направления обмена. Больше заявок Вам поставить пока нельзя, но Вы можете уменьшить свое количество заявок путем их объединения. Для этого выберите уже имеющуюся заявку с предпочтительным для Вас курсом из своего списка новых заявок и там воспользуйтесь операцией объединения (внизу списка операций), чтобы присоединить другие заявки к выбранной.
    7 Еще не прошло 5 минут после постановки Вами заявки сданной суммой, подождите 5 минут или измените сумму заявки минимум на 0.01
    41 Result return error, try again
    51 Error occurred (database level), descrition:
    128 Error occurred (unknown), number &RetVal&