Перейти в режим автора

Интерфейс X4

Интерфейс X4. Получение истории выписанных счетов по кошельку. Проверка оплаты счета.

<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-интерфейсы