Page History
...
Code Block | ||
---|---|---|
| ||
<message> <authorization> <login> Значение свойства outlogin внешней системы. </login> <password> Значение свойства outpassword внешней системы. </password> </authorization > <event type="AFS_CHANGED"> <payment> <id> Иденитификатор платежа во внешней системе <id> <fstatus> Код из справочника фрод‑статусов (см. табл. 3.1раздел "Взаимодействие между системами"). </fstatus > <reason> Код из справочника причин фрод‑статусов (см. табл. 4.2раздел "Взаимодействие между системами"). </reason> < /payment> </event> <message> |
...
Code Block | ||
---|---|---|
| ||
<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. Если соединения с сервисом не произойдет или запрос будет обработан неуспешно, то сообщение считается недоставленным. Следующая попытка будет произведена через определенный промежуток времени, при этом количество попыток ограничено.
Anchor | ||||
---|---|---|---|---|
|
Поддерживаемые внешней системой сервисы необходимо зарегистрировать в СПМ. Для этого следует передать в службу технической поддержки СПМ описание доступа к интерфейсам оповещения (web-сервисам), SSL-сертификат для доверительного распознавания внешней системы в СПМ, а также указать URL для доступа и тип обрабатываемого события. При необходимости (если это предусмотрено технологическими особенностями сервиса приема информации внешней системы) можно также передать наименование учетной записи (логин) и пароль, которые будут содержаться во всех XML-документах, поступающих от СПМ.
Для обеспечения отказоустойчивости внешняя система может поддерживать более одного URL для приема информации об одном и том же событии. В этом случае информация должна передаваться на первый доступный сервис.