WebMoney

Wiki

Интерфейсы сервиса Cash Exchanger

Интерфейс для секции P-2-P Exchanger

p2p.exchanger.ru

Метод ListActive - Получение списка активных заявок

Метод позволяет получить список заявок опубликованных на бирже p2p.exchanger.ru, с учетом параметров для фильтрации

название описание примечание
reqNumber номер запроса, уникальное целое число, не меньше чем reqNumber предыдущего запроса
wmidSigner WMID подписчика
sign цифровая подпись reqNumber+transportId+wmidSigner
transportId ID типа обмена 1- wire, 2- sdp, 3 - reserved, 4 - p2p
directionId ID направления обмена 1 - WMZ=>USD, 2 - WMR=>RUB, 3 - WMU=>UAH, 4 - WMY=>UZS, 5 - WMB=>BYR, 6 - WME=>EUR, 7 - USD=>WMZ, 8 - RUB=>WMR, 9 - UAH=>WMU, 10 - UZS=>WMY, 11 - BYR=>WMB, 12 - EUR=>WME
cityId ID города
amountGreater сумма обмена не меньше чем amountGreater null или -1 если не задан
rateDirectGreater прямой курс не меньше чем rateDirectGreater null или -1 если не задан
rateReverseGreater обратный курс не меньше чем amountGreater null или -1 если не задан
out resultList список заявок, выходной параметр
out error описание ошибки, выходной параметр
  • возвращает true - если успешно завершен

Метод ListOwn - Получение списка своих заявок

Метод позволяет получить список собственных заявок на бирже p2p.exchanger.ru

название описание примечание
reqNumber номер запроса, уникальное целое число, не меньше чем reqNumber предыдущего запроса
wmidSigner WMID подписчика
sign цифровая подпись reqNumber + wmidSigner + status
status статус заявок для получения [-1] - все заявки
out resultList список заявок, выходной параметр
out error описание ошибки, выходной параметр
  • возвращает true - если успешно завершен

Метод New - Создание новой заявки (без публикации)

Создает новую заявку в секции p2p биржи Cash Exchanger, но не публикует в списках обмена

название описание примечание
reqNumber номер запроса, уникальное целое число, не меньше чем reqNumber предыдущего запроса
wmidSigner WMID подписчика
sign цифровая подпись reqNumber+directionId+purseNum+amount+amountWant+insPrem+wmidSigner
directionId ID направления обмена
purseNum кошелек
amount сумма есть
amountWant сумма надо
insPrem сумма страхового взноса
maxTimeForExchange время в течении которого должен произойти обмен (24 часа по умолчанию)
meetDateTime время встречи не меньше чем текущее время + 1 час, формат yyyyMMddHHmm
address место встречи, адрес
metro место встречи, станция метро
cityId ID города
description дополнительная информация
out error описание ошибки, выходной параметр
out offer публичная оферта, выходной параметр
out uniqId номер созданной заявки, выходной параметр
  • возвращает true - если успешно завершен

Метод Publish - Опубликовать заявку в списках

Публикация заранее созданной заявки в списках обмена

название описание примечание
reqNumber номер запроса, уникальное целое число, не меньше чем reqNumber предыдущего запроса
wmidSigner WMID подписчика
sign цифровая подпись reqNumber+uniqId+wmidSigner
uniqId WMID подписчика
out error описание ошибки, выходной параметр
out cmdGuid GUID команды, выходной параметр (используется для проверки результата)
  • возвращает true - если успешно завершен

Метод PublishResult - Получить результаты публикации заявки

Получение результатов публикации

название описание примечание
reqNumber номер запроса, уникальное целое число, не меньше чем reqNumber предыдущего запроса
wmidSigner WMID подписчика
sign цифровая подпись reqNumber+uniqId+cmdGuid+wmidSigner
uniqId WMID подписчика
cmdGuid GUID команды возвращенной методом Publish
out error описание ошибки, выходной параметр
out validationErrors ошибки публикации, выходной параметр
out status статус заявки, выходной параметр
  • возвращает true - если успешно завершен

Метод GetIntentionsList - Получить список намерений на обмен по номеру заявки

Получить список намерений на обмен по выбранной заявке

название описание примечание
reqNumber номер запроса, уникальное целое число, не меньше чем reqNumber предыдущего запроса
wmidSigner WMID подписчика
sign цифровая подпись reqNumber + appUniqId + wmidSigner
appUniqId уникальный номер прямой заявки
out error описание ошибки
out result список намерений на обмен
  • возвращает true - если успешно завершен

Метод SendIntensions - Подать намерение на обмен

Подача намерения на обмен

название описание примечание
reqNumber номер запроса, уникальное целое число, не меньше чем reqNumber предыдущего запроса
wmidSigner WMID подписчика
sign цифровая подпись reqNumber+appUniqId+purseNumber+wmidSigner
appUniqId уникальный номер прямой заявки, на основе которой подается встречная
purseNumber номер кошелька контрагента
out error описание ошибки
out guid guid команды на подачу встречной заявки
  • возвращает true - если успешно завершен

Метод CounterTrade - Инициализировать обмен на основе выбранного намерения

Инициализация обмена на основе выбранного намерения на обмен (объединение прямой заявки и намерения)

название описание примечание
reqNumber номер запроса, уникальное целое число, не меньше чем reqNumber предыдущего запроса
wmidSigner WMID подписчика
sign цифровая подпись reqNumber+appId+purseNumber+wmidSigner
appUniqId уникальный номер прямой заявки, на основе которой подается встречная
purseNumber номер кошелька контрагента
out error описание ошибки
out guid guid команды на подачу встречной заявки
  • возвращает true - если успешно завершен

Метод CounterTradeResult - Проверка результатов инициализации обмена

название описание примечание
reqNumber номер запроса, уникальное целое число, не меньше чем reqNumber предыдущего запроса
wmidSigner WMID подписчика
sign цифровая подпись reqNumber+appId+purseNumber+wmidSigner
cmdGuid GUID команды на подачу встречной заявки
uniqId номер заявки
out error описание ошибки
out status статус заявки
  • возвращает true - если успешно завершен

Использование интерфейса для работы с секцией P-2-P Exchanger

Регистрация обменного пункта на сервисе Cash Exchanger

Чтобы использовать библиотеку или web-сервис, нужно иметь аттестат не ниже формального.
Также необходима регистрация на сервисе Cash Exchanger. Для этого нужно посетить одну из секций http://cash.exchanger.ru, авторизоваться своим WMID и добавить кошельки (предоставить доверие для WMID сервиса).

Генерация ключа для работы с тестовым приложением

После регистрации, необходимо сформировать XML-ключ на основе ключа от вашего Keeper WinPro.
Скачайте приложение для генерации ключа тут или на сайте разработчика.
Более подробно об использовании приложения, читайте в разделе WMSignerFX

В результате будет получен XML-ключ в следующем виде:

<RSAKeyValue>
  <Modulus>KEY PART 1</Modulus>
  <D>KEY PART 2</D>
</RSAKeyValue>

Далее, необходимо данный XML-ключ сохранить в файле key.xml, который в дальнейшем будет указан для тестового приложения.

Тестовое приложение для работы с секцией p2p.exchanger.ru

Тестовое приложение, с открытыми исходными кодами доступно для скачивания на странице. В данном тестовом приложении приведены основные способы вызова веб-методов, для:

  • получения списка доступных заявок
  • получения списка своих заявок
  • добавления намерения на обмен
  • инициирования обмена на основе намерения