книги хакеры / журнал хакер / 081_Optimized

все интерфейсы WM отлично документированы, но не все они открыты для свободного доступа

[юзаем интерфейсы] Первым делом давай разберемся с работой одного простого примера, который нам заботливо приготовили разработчики компании WebMoney. Для этого возьми с нашего диска архив wmex_php, залей его на хост, помести внутрь папки файл WMSigner с настройками, отредактируй файл настроек wmconst.inc. Все это делается по наитию и секунд за 25.

После этого ты уже сможешь легко работать с тестовыми примерами. Давай попробуем с тобой воспользоваться интерфейсом «Выписывание счета от одного участника другому». Для этого достаточно заполнить все поля и клацнуть на кнопку отправки запроса. Если все работает верно и ты все нормально настроил, тебе покажут номер счета и сообщат, что он выписан нормально. Хотя я на 100% уверен, что у тебя сразу возникнет сообщение «Ошибка связи с сертификационным центром WebMoney». Первая причина, по которой это может произойти, заключается в том, что у тебя может быть не установлен пакет сURL, который нужен нам для работы. Если он не стоит, его необходимо инсталлировать в системе — о том, как это сделать, написано в соответствующей врезке. А вторая причина, по которой у тебя точно возникнет эта ошибка, заключается в том, что в SSL не установлен сертификат для связи с wm-сервером. Сле-

КОДИНГ 129]

[XÀÊÅÐ 09 [81] 05 >

КОДИНГ 130]

[XÀÊÅÐ 09 [81] 05 >

сборка WMSinger под FreeBSD

дует скачать этот сертификат с www.webmoney.ru, разместить его на твоем сервере в доступном сценариям месте и внутри файла wm.inc найти функцию _HttpReq:

[код функции, реализующий HTTPS-запрос]

function _HttpsReq($addr)

{

$ch = curl_init("https://w3s.webmoney.ru".$addr); curl_setopt($ch, CURLOPT_HEADER, 0); curl_setopt($ch, CURLOPT_RETURNTRANSFER,1); curl_setopt($ch, CURLOPT_SSL_VERIFYPEER, FALSE); curl_setopt($ch, CURLOPT_CAINFO,

"/home/apache/ired/htdocs/pay/wm.crt"); # здесь надо указать путь к сертификату, или можно установить его в SSL $result=curl_exec($ch);

curl_close($ch); return $result;

}

Если возиться с сертификатами не хочется, а хочется побыстрее попробовать систему в действии, нужно заменить строку curl_setopt($ch, CURLOPT_CAINFO…) на curl_setopt($ch, CURLOPT_SSL_VERIFYPEER, FALSE). Хоть делать так разработчики не советуют, нашим опытам это не помешает ни капельки. Другое дело, что так нельзя делать с большим магазином, где крутятся деньги.

После того, как ты исправишь функцию _HttpsReq, или установишь сертификат, все должно заработать. Теперь давай разберемся с тем, как функционирует эта программа. В файле wm.inc найди функцию InvCreate:

[код фукнции, реализующей выписку счета через https-интерфейс]

function InvCreate($wmid, $summ, $inv_id, $dsc, $adr)

{

#поскипано, тут объявляются переменные $PlanStr =

"$OrderID$LoginOfCust$PurseOfStores$Amount$Desc$InvAddress$Perio d$Experation$RequestN";# прописываемая строка запроса

$SignStr = _GetSign($PlanStr); # формируется подпись запроса $W3sUrl="/asp/Invoice.asp?SL=$LoginOfStores&SP=$PurseOfStores&C L=$LoginOfCust&IN=$OrderID&D=".urlencode($Desc)."&AD=".urlencode($InvAddress)."&A=$Amount&E=$Experation&P=$Period&RN=$Req uestN&SS=$SignStr";# соствляется URL get-запроса

$httpsRes = _HttpsReq($W3sUrl); # выполняется запрос

if (substr($httpsRes,0,6) == "Error:") # разбирается ответ, если произошла ошибка

{

$errCode = sprintf("%d", substr($httpsRes,6)); # получается код ошибки

#поскипано. Тут в зависимости от кода ошибки выводятся разные

#сообщения

if (substr($httpsRes,0,8) == "WMInvId:") #Если все выполнилось нормально

{

$wminv_id = sprintf("%d", substr($httpsRes,8)); # получаем номер счета } return array($wminv_id, $err);

}

вот так выглядят сорцы WMSinger

Как видишь, все просто. Фактически, работа функции сводится к формированию URL, к которому следует обратиться, чтобы выполнить транзакцию. В самом деле: из параметров запроса, согласно документации, формируется подписываемая строка, затем, при помощи функции _GetSign, формируется ЦП, которая помещается в качестве параметра запроса с именем SS. После того, как в соотвествующие GET-поля, согласно документации, установлены значения параметров запроса, при помощи функции _HttpReq он отправляется серверу, и происходит нехитрая обработка ответа. Что касается функции _GetSign, то идеологи- чески работает она просто: при помощи знакомой тебе функции popen открывается пайп с процессом WMSigner, туда вдувается подписываемая строка и извлекается ЦП запроса. Что касается _HttpReq, то этот блок кода приведен чуть выше. Легко увидеть, что он использует в своей работе функции curl, краткое описание которых ты найдешь в соответствующей документации на нашем диске.

[другие интерфейсы] Как я уже говорил, в системе WM доступно большое количество интерфейсов: для перевода средств, отправки сообщений по внутренней почте и т.д. К сожалению, в свободном доступе находится лишь небольшая их часть, для доступа к остальным нужна регистрация. Но нам это не помешает. Как видишь, мы уже с тобой разобрались с работой Https-интерфейса, выписывающего покупателю счет. На нашем диске ты найдешь мой скрипт, реализующий тоже самое, но через более современный XML-интерфейс. Приводить здесь его код и описывать работу я не буду, незачем повторяться, лучше мы напишем приложение, которое будет проверять, оплачен ли выписанный ранее счет, или нет. Дело в том, что интерфейс, позволяющий напрямую переводить деньги, закрыт от свободного доступа, и, чтобы придать законченность изложению, мы будем использовать такую схему: покупателю выписывается счет за товар, он его оплачивает, сценарий проверяет это, и, если счет оплачен, регистрирует этот факт. Если получить доступ к интерфейсу прямого перевода денег, эта схема упрощается. Но настоящая правда в том, что работают все эти гейты абсолютно одинаково и нам сейчас с тобой главное научиться как следует их использовать. А переделать приложение под конкретный интерфейс — дело 30 секунд. Ты главное разберись как следует с этим.

[варим xml] Проверка перевода средств между кошельками осуществляется через гейт https://w3s.webmoney.ru/asp/XMLOperations.asp. Для реализации запроса необходимо составить POST-запрос для этого сценария в следующем формате:

[формат запроса на получение информации об оплате счета]

<w3s.request>

<reqn>$reqn</reqn> # номер запроса должен быть больше предыдущего идентификатора

<wmid>$wmid</wmid> # WMId подписавшего запрос <sign>$sign</sign> # ЦП запроса

<getoutinvoices> # Информация об интересующих счетах <purse>$storepurce</purse>#кошелек, для оплаты на который выпи сывались счета

<wminvid>$invc_n</wminvid># необязательно: номер счета <orderid></orderid># необязательно:номер заказа внутри магазина <datestart>$datestart</datestart># обязательно: начало временного

менного промежутка создания счета </getoutinvoices>

</w3s.request>

Цифровая подпись для этого запроса изготавливается из строки $storepurce.$reqn, но есть из склеенного номера кошелька и номера запроса. После того, как мы составили данные POST-запроса, необходимо создать сам заголовок, который будет отправлен web-серверу. Это обыкновенная строка, которая начинается так:

$header = "POST ".$page." HTTP/1.0 \r\n"; $header .= "MIME-Version: 1.0 \r\n";

Она представляет собой набор заполненных, согласно RFC, стандартных полей. Я не буду об этом подробно рассказывать — на нашем диске в моем примере ты увидишь, как это делается. Или можешь легко найти в инете любой пример. После того, как заголовок создан, необходимо при помощи функций cURL отправить его серверу:

# во всех процедурах $fo,$currentTag и $res — глобальные переменные function startElement($parser, $name, $att)

{

$currentTag=$name;

if($name=="outinvoice" && $att["id"]==$_POST[wm_invc_n]) $fo=1;

}

function endElement($parser, $name) { if($name==="outinvoice" && $fo===1) $fo=0;

}

function characterData($parser,$data) { if($fo===1) { if($currentTag=="amount") $res=$data;

}}

После парсинга данных в глобальной переменной $res окажется код результата запроса:

$ch = curl_init($url);

curl_setopt($ch, CURLOPT_SSL_VERIFYPEER, FALSE); curl_setopt($ch, CURLOPT_RETURNTRANSFER, 1); curl_setopt($ch, CURLOPT_CUSTOMREQUEST, $header); $data = curl_exec($ch);

После этого в $data будет помещен результат выполнения запроса — документ следующего вида:

[формат ответа сервера]

<w3s.response>

<reqn></reqn>

<retval></retval>

<retdesc></retdesc> <outinvoices cnt="n" >

<outinvoice id="n1" ts="n2">

#здесь куча полей с инфой о счетах. Нас интересует только

#state — состояние счета

</outinvoice> <outinvoice>...</outinvoice>

</outinvoices>

</w3s.response>

Соответственно, для обработки этого XML-документа нужно использовать встроенный в PHP парсер:

$parser=xml_parser_create(); xml_parser_set_option($parser,XML_OPTION_CASE_FOLDING,0); xml_set_element_handler($parser, "startElement", "endElement"); xml_set_character_data_handler($parser, "characterData"); xml_parse($parser,$data);

Как видно из этого кода, я объявил следующие функции для обработки открывающего и закрывающего тегов элементов: startElement и endElement. Анализ символьных данных будет реализовываться при помощи функции characterData. Чтобы не быть голословным и чтобы тебе все было предельно понятно, приведу здесь код этих функций:

–0 — счет не оплачен

–1 — счет оплачен по протекции

–2 — счет оплачен окончательно

–3 — в оплате счета отказано

[чему мы научились] Мы с тобой научились, в общем-то, всей несложной науке проведения автоматических транзакций в системе WM. По идее, теперь для тебя не должно быть проблемой написать скрипт, который будет отправлять сообщение по внутренней почте, или осуществлять прямой перевод денег. Все это реализуется абсолютно аналогично по разобранным мной примерам — ты умеешь использовать как https, так и xml-интерфейсы системы и реализовать любую задачу для тебя будет несложно, пусть и подглядывая в эту статью. Если у тебя остались какие-то вопросы, советую обратиться к документации на нашем диске, или напрямую на сайт WM: www.webmoney.ru/pfdevelopers.shtml. Удачи. Если у тебя есть вопросы, которые ты никак не можешь решить, то, так уж и быть, пиши мне на nikitoz@real.xakep.ru. Только не забудь перед этим положить на Z557712535333 долларов 50, ok? :)

пришел выписанный моим скриптом счет на оплату

КОДИНГ 131]

тестовая форма для выписывания счета

XÀÊÅÐ 09 [81] 05 >

FERRUM

PC_ZONE

ИМПЛАНТ

ВЗЛОМ

СЦЕНА

UNIXOID

КОДИНГ

[КРЕАТИФФ]

ЮНИТЫ

Загадки Нострадамуса

КИРЯКИН С КРИКОМ ВСКОЧИЛ С ПОСТЕЛИ. ЛЕЖАЩАЯ РЯДОМ ЛАРИСА С ТРЕВОГОЙ СМОТРЕЛА НЕ НЕГО И ПОПЫТАЛАСЬ УСПОКОИТЬ..

mindw0rk (mindw0rk@gameland.ru)

Часть третья

— Сегодня?

— Чем могу вам помочь? — поинтересовалась администратор у заблу-

[XАКЕР 09 [81] 05 > КРЕАТИФФ 136]