| Правильная ссылка на эту статью: |
Интерфейсы сервиса Cash Exchanger
Интерфейс для секции P-2-P Exchanger¶
Метод ListActive - Получение списка активных заявок¶
Метод позволяет получить список заявок опубликованных на бирже p2p.exchanger.ru, с учетом параметров для фильтрации
- URL Метода SOAP - https://cash.exchanger.ru/srv/serviceforp2p.asmx?op=ListActive
| название | описание | примечание |
| 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, 5 - WMB=>BYR, 6 - WME=>EUR, 7 - USD=>WMZ, 8 - RUB=>WMR, 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
- URL Метода SOAP - https://cash.exchanger.ru/srv/serviceforp2p.asmx?op=ListOwn
| название | описание | примечание |
| reqNumber | номер запроса, уникальное целое число, не меньше чем reqNumber предыдущего запроса | |
| wmidSigner | WMID подписчика | |
| sign | цифровая подпись | reqNumber + wmidSigner + status |
| status | статус заявок для получения | [-1] - все заявки |
| out resultList | список заявок, выходной параметр | |
| out error | описание ошибки, выходной параметр |
- возвращает true - если успешно завершен
Метод New - Создание новой заявки (без публикации)¶
Создает новую заявку в секции p2p биржи Cash Exchanger, но не публикует в списках обмена
- URL Метода SOAP - https://cash.exchanger.ru/srv/serviceforp2p.asmx?op=New
| название | описание | примечание |
| 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 - Опубликовать заявку в списках¶
Публикация заранее созданной заявки в списках обмена
- URL Метода SOAP - https://cash.exchanger.ru/srv/serviceforp2p.asmx?op=Publish
| название | описание | примечание |
| reqNumber | номер запроса, уникальное целое число, не меньше чем reqNumber предыдущего запроса | |
| wmidSigner | WMID подписчика | |
| sign | цифровая подпись | reqNumber+uniqId+wmidSigner |
| uniqId | WMID подписчика | |
| out error | описание ошибки, выходной параметр | |
| out cmdGuid | GUID команды, выходной параметр (используется для проверки результата) |
- возвращает true - если успешно завершен
Метод PublishResult - Получить результаты публикации заявки¶
Получение результатов публикации
- URL Метода SOAP - https://cash.exchanger.ru/srv/serviceforp2p.asmx?op=PublishResult
| название | описание | примечание |
| reqNumber | номер запроса, уникальное целое число, не меньше чем reqNumber предыдущего запроса | |
| wmidSigner | WMID подписчика | |
| sign | цифровая подпись | reqNumber+uniqId+cmdGuid+wmidSigner |
|---|---|---|
| uniqId | WMID подписчика | |
| cmdGuid | GUID команды возвращенной методом Publish | |
| out error | описание ошибки, выходной параметр | |
| out validationErrors | ошибки публикации, выходной параметр | |
| out status | статус заявки, выходной параметр |
- возвращает true - если успешно завершен
Метод GetIntentionsList - Получить список намерений на обмен по номеру заявки¶
Получить список намерений на обмен по выбранной заявке
- URL Метода SOAP - https://cash.exchanger.ru/srv/serviceforp2p.asmx?op=GetIntentionsList
| название | описание | примечание |
| reqNumber | номер запроса, уникальное целое число, не меньше чем reqNumber предыдущего запроса | |
| wmidSigner | WMID подписчика | |
| sign | цифровая подпись | reqNumber + appUniqId + wmidSigner |
|---|---|---|
| appUniqId | уникальный номер прямой заявки | |
| out error | описание ошибки | |
| out result | список намерений на обмен |
- возвращает true - если успешно завершен
Метод SendIntensions - Подать намерение на обмен¶
Подача намерения на обмен
- URL Метода SOAP - https://cash.exchanger.ru/srv/serviceforp2p.asmx?op=SendIntensions
| название | описание | примечание |
| reqNumber | номер запроса, уникальное целое число, не меньше чем reqNumber предыдущего запроса | |
| wmidSigner | WMID подписчика | |
| sign | цифровая подпись | reqNumber+appUniqId+purseNumber+wmidSigner |
| appUniqId | уникальный номер прямой заявки, на основе которой подается встречная | |
| purseNumber | номер кошелька контрагента | |
| out error | описание ошибки | |
| out guid | guid команды на подачу встречной заявки |
- возвращает true - если успешно завершен
Метод CounterTrade - Инициализировать обмен на основе выбранного намерения¶
- URL Метода SOAP - https://cash.exchanger.ru/srv/serviceforp2p.asmx?op=CounterTrade
Инициализация обмена на основе выбранного намерения на обмен (объединение прямой заявки и намерения)
| название | описание | примечание |
| reqNumber | номер запроса, уникальное целое число, не меньше чем reqNumber предыдущего запроса | |
| wmidSigner | WMID подписчика | |
| sign | цифровая подпись | reqNumber+appId+purseNumber+wmidSigner |
|---|---|---|
| appUniqId | уникальный номер прямой заявки, на основе которой подается встречная | |
| purseNumber | номер кошелька контрагента | |
| out error | описание ошибки | |
| out guid | guid команды на подачу встречной заявки |
- возвращает true - если успешно завершен
Метод CounterTradeResult - Проверка результатов инициализации обмена¶
- URL Метода SOAP - https://cash.exchanger.ru/srv/serviceforp2p.asmx?op=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¶
Тестовое приложение, с открытыми исходными кодами доступно для скачивания на странице. В данном тестовом приложении приведены основные способы вызова веб-методов, для:
- получения списка доступных заявок
- получения списка своих заявок
- добавления намерения на обмен
- инициирования обмена на основе намерения