5. Реализация интерфейса оповещения

Программные интерфейсы внешней системы могут обрабатывать информацию о событиях, получаемую от СПМ. СПМ передает информацию о событиях в виде XML-документов путем HTTPS-запросов методом POST.

На текущий момент от СПМ во внешнюю систему может поступать информация о следующих событиях:

изменение фрод-статуса платежной операции;
автоматическое создание мерчанта в СПМ.

XML-документ для извещения об изменении фрод-статуса платежной операции имеет следующий вид:

<message>
      <authorization>
             <login>
                 Значение свойства outlogin внешней системы. 
             </login>
             <password>
                  Значение свойства outpassword внешней системы.  
             </password>
        </authorization >
        <event type="AFS_CHANGED">
              <payment>
                  <id>
             Иденитификатор платежа во внешней системе
           <id>
                   <fstatus>
                      Код из справочника фрод‑статусов (см. табл. 3.1).
            </fstatus >
                   <reason>
                       Код из справочника причин фрод‑статусов (см. табл. 3.2).
                   </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

Внешняя система может реализовать сервисы приема информации о событиях в СПМ для асинхронного анализа результатов проверки платежных операций (см.п.4.1) и/или для передачи уточняющих данных по мерчанту (см.п.4.4). Для этого во внешней системе необходимо использовать web-сервер, получающий HTTPS-запросы от СПМ. В теле этих запросов будут передаваться XML-документы с информацией о событии в СПМ. Web-сервис внешней системы должен извлечь данные из XML в соответствии с описанной в файле DTD структурой и выполнить необходимые действия.

Content

Space Tools