Правильная ссылка на эту статью: |
Интерфейс X4
Интерфейс X4. Получение истории выписанных счетов по кошельку. Проверка оплаты счета.¶
- URL для передачи запроса с авторизацией по ключам WM Keeper WinPro - https://w3s.webmoney.ru/asp/XMLOutInvoices.asp
- URL для передачи запроса с авторизацией по ключам WM Keeper WebPro - https://w3s.wmtransfer.com/asp/XMLOutInvoicesCert.asp
(при возникновении проблем с сертификатом сервера, можно обращаться по альтернативному URL https://w10s.webmoney.ru) - метод - POST
- формат запроса:
<w3s.request> <reqn></reqn> <wmid></wmid> <sign></sign> <getoutinvoices> <purse></purse> <wminvid></wminvid> <orderid></orderid> <datestart></datestart> <datefinish></datefinish> </getoutinvoices> </w3s.request>
- параметры запроса:
название | назначение | примечание |
reqn | номер запроса | целое без знака, макс. количество цифр - 15; всегда должен быть больше номера предыдущего запроса!!! |
wmid | WMID подписавшего запрос | используется только при авторизации с ключами WM Keeper WinPro |
sign | подпись запроса - формируется из параметров: purse+reqn | используется только при авторизации с ключами WM Keeper WinPro |
getoutinvoices | параметры запрашиваемого счета(счетов), по которым ведется поиск | обязательные параметры purse, datestart, datefinish, остальные можно не задавать или указывать 0; если заданы wminvid то orderid, datestart и datefinish не используются для поиска счетов |
getoutinvoices\purse | номер кошелька для оплаты на который выписывался счет | |
getoutinvoices\wminvid | номер счета (в системе WebMoney) | целое число > 0 |
getoutinvoices\orderid | номер счета | номер счета в системе учета магазина, не больше 999999999999999 |
getoutinvoices\datestart | минимальное время и дата создания счета | ГГГГММДД ЧЧ:ММ:СС UTC+3 |
getoutinvoices\datefinish | максимальное время и дата создания счета | ГГГГММДД ЧЧ:ММ:СС UTC+3 |
Внимание! Если в запросе задан номер счета в системе WebMoney (значение больше 0), остальные параметры (диапазон дат и номер счета в системе учета магазина) не используются при поиске.
- формат ответа:
<w3s.response> <reqn></reqn> <retval></retval> <retdesc></retdesc> <outinvoices cnt="n" > <outinvoice id="n1" ts="n2"> <orderid></orderid> <customerwmid></customerwmid> <storepurse></storepurse> <amount></amount> <desc></desc> <address></address> <period></period> <expiration></expiration> <state></state> <datecrt></datecrt> <dateupd></dateupd> <wmtranid></wmtranid> </outinvoice> <outinvoice>...</outinvoice> </outinvoices> </w3s.response>
- параметры ответа:
название | назначение | примечание |
reqn | номер запроса | |
retval | код выполнения запроса | 0 - запрос выполнен |
retdesc | расшифровка кода выполнения запроса | |
outinvoices | список выписанных счетов, полученных по запросу | атрибут n - кол-во счетов, удовлетворяющих запросу |
outinvoices\outinvoice | параметры счета | атрибут id - уникальный номер счета в системе учета WebMoney атрибут ts - служебный номер счета в системе учета WebMoney |
outinvoice\orderid | номер счета | номер счета перевода в системе учета отправителя;не больше 999999999999999 |
outinvoice\customerwmid | WMID покупателя, которому был выписан счет | |
outinvoice\storepurse | номер кошелька, на который необходимо оплатить счет | |
outinvoice\amount | сумма счета, выставленная для оплаты покупателю | |
outinvoice\desc | описание товара или услуги, на который выписывается счет | |
outinvoice\address | адрес доставки товара | |
outinvoice\period | максимально возможный при оплате счета срок протекции сделки в днях | При выписке счета для получения средств на WMD-кошелек - максимальный срок возврата кредита в днях |
outinvoice\expiration | максимально допустимый срок оплаты счета в днях | |
outinvoice\state | состояние оплаты счета | 0 - не оплачен 1 - оплачен по протекции 2 - оплачен окончательно 3 - отказан |
outinvoice\datecrt | дата и время создания счета | |
outinvoice\dateupd | дата и время последнего изменения состояния счета | |
outinvoice\wmtranid | номер операции в системе WebMoney | 0 - оплаты не было, > 0 - счет оплачен |
outinvoice\customerpurse | кошелек плательщика, если счет оплачен |
•код выполнения запроса:
код | описание |
111 | попытка запроса информации по кошельку не принадлежащему WMID, которым подписывается запрос; при этом доверие не установлено. |
см. также XML-интерфейсы