External system can handle the event notifications from SOFI. SOFI sends the event notifications as XML-document via HTTPS-request (method POST).
At the moment SOFI can send notifications about following events:
- payment operation fraud-status has been changed;
- merchant profile was automatically created in SOFI.
Notification XML-document for fraud-status change event has the following form:
<message>
<authorization>
<login>
outlogin
</login>
<password>
outpassword
</password>
</authorization >
<event type="AFS_CHANGED">
<payment>
<id>
Payment id
<id>
<fstatus>
Fraud-status code (see Table 4.1)
</fstatus >
<reason>
Fraud-status setting reason code (see table 4.2)
</reason>
< /payment>
</event>
<message>
Notification XML-document for merchant auto-creation event has the following form:
<message>
<authorization>
<login>
outlogin
</login>
<password>
outpassword
</password>
</authorization >
<event type="MERCHANT_AUTO_CREATE">
<merchant>
<id>
Merchant ID
<id>
<paymentId>
Payment ID which was used for auto-creation
</paymentId>
</merchant>
</event>
<message>
The document can contain several fraud-statuses or auto-created merchants. Tag <event> contain the corresponding number of tags <payment> or <merchant>.in such cases.
Examples (XML – example of documents and DTD – file for XML creation) can be received by following addresses:
https://afs-api.paysecure.ru/doc/event.xml