Программные интерфейсы внешней системы могут обрабатывать информацию о событиях, получаемую от СПМ. СПМ передает информацию о событиях в виде XML-документов путем HTTPS-запросов методом POST.
На текущий момент от СПМ во внешнюю систему может поступать информация о следующих событиях:
- изменение фрод-статуса платежной операции;
- автоматическое создание мерчанта в СПМ.
XML-документ для извещения об изменении фрод-статуса платежной операции имеет следующий вид:
<message>
<authorization>
<login>
Значение свойства outlogin внешней системы.
</login>
<password>
Значение свойства outpassword внешней системы.
</password>
</authorization >
<event type="AFS_CHANGED">
<payment>
<id>
Иденитификатор платежа во внешней системе
<id>
<fstatus>
Код из справочника фрод‑статусов (см. раздел "Взаимодействие между системами").
</fstatus >
<reason>
Код из справочника причин фрод‑статусов (см. раздел "Взаимодействие между системами").
</reason>
< /payment>
</event>
<message>
XML-документ для извещения об автоматическом создании мерчанта в СПМ имеет следующий вид:
<message>
<authorization>
<login>
Значение свойства outlogin внешней системы.
</login>
<password>
Значение свойства outpassword внешней системы.
</password>
</authorization >
<event type="MERCHANT_AUTO_CREATE">
<merchant>
<id>
Иденитификатор мерчанта во внешней системе
<id>
<paymentId>
Идентификатор операции во внешней системе, по которому был добавлен мерчант
</paymentId>
</merchant>
</event>
<message>
Документ может содержать информацию по нескольким платежным операциям или мерчантам одновременно. В этом случае в теге <event> должно содержаться соответствующее количество тегов <payment> или <merchant>.
Примеры (XML - пример готового документа с информацией о событиях СПМ и DTD - файл описания синтаксических правил для создания XML) можно найти по адресам:
https://afs-api.paysecure.ru/doc/event.xml
https://afs-api.paysecure.ru/doc/notification.dtd
Внешняя система может реализовать сервисы приема информации о событиях в СПМ для асинхронного анализа результатов проверки платежных операций и/или для передачи уточняющих данных по мерчанту. Для этого во внешней системе необходимо использовать web-сервер, получающий HTTPS-запросы от СПМ. В теле этих запросов будут передаваться XML-документы с информацией о событии в СПМ. Web-сервис внешней системы должен извлечь данные из XML в соответствии с описанной в файле DTD структурой и выполнить необходимые действия.
При успешной обработке запроса сервис должен отправить в СПМ ответ с HTTP Response Status кодом 200. Если соединения с сервисом не произойдет или запрос будет обработан неуспешно, то сообщение считается недоставленным. Следующая попытка будет произведена через определенный промежуток времени, при этом количество попыток ограничено.
Поддерживаемые внешней системой сервисы необходимо зарегистрировать в СПМ. Для этого следует передать в службу технической поддержки СПМ описание доступа к интерфейсам оповещения (web-сервисам), SSL-сертификат для доверительного распознавания внешней системы в СПМ, а также указать URL для доступа и тип обрабатываемого события. При необходимости (если это предусмотрено технологическими особенностями сервиса приема информации внешней системы) можно также передать наименование учетной записи (логин) и пароль, которые будут содержаться во всех XML-документах, поступающих от СПМ.
Для обеспечения отказоустойчивости внешняя система может поддерживать более одного URL для приема информации об одном и том же событии. В этом случае информация должна передаваться на первый доступный сервис.