API Products of the Mir payment system

Dispute API documentation

Service SiomAPI

Method Send

The Send method is used to add new records to SIOM

Method address: /webapi/v1/SiomApi/Send
Request type: post

REQUEST DETAILS
Key Data type Description
items array of ApiSiomPacketItem Array of transactions to add to SIOM
X-Authorization* string Access token value, which was received as result of method Login
RESPONCE DETAILS 200
Key Data type Description
success boolean Action result
errorMessage string Error message
result integer Result

An example of HTTP request

JSON
POST https://<Имя сервера Диспут+>/webapi/v1/SiomApi/Send HTTP/1.1
Host: <Имя сервера Диспут+>
Connection: keep-alive
Content-Length: 2559 
Accept: application/json
Content-Type: application/json
Accept-Encoding: gzip, deflate
Accept-Language: ru-RU,ru;q=0.8
X-Authorization: Bearer <значение маркера доступа>
{
  "items": [
       {
      "arn": "<ARN>",
      "authDate": "2020-01-20",
      "fraudStatus": "2",
      "fraudType": "04",
      "comment": "Security check"
    },
      {
      "pan": "<PAN>",
      "rrn": "<RRN>",
      "authDate": "2019-12-09",
      "fraudStatus": "3",
      "fraudType": "99",
      "comment": "не мошенничество"
    },
      {
      "pan": "<PAN>",
      "rrn": "<RRN>",
       "mti": "0100",
      "authDate": "2019-11-11",
      "fraudStatus": "1",
      "fraudType": "04",
      "comment": "Подтвержденный фрод"
    },
      {
      "pan": "<PAN>",
       "arn": "",
      "rrn": "<RRN>",
       "mti": "0100",
      "authDate": "2019-11-11",
      "fraudStatus": "1",
      "fraudType": "04",
      "comment": "занесение по авторизации mti=0100"
    },
     {
      "pan": "<PAN>",
      "arn": "<ARN>",
      "rrn": "",
       "mti": "1240",
      "authDate": "2019-11-11",
      "fraudStatus": "1",
      "fraudType": "04",
      "comment": "занесение по клирингу mti=1240"
    },
      {
      "pan": "<PAN>",
      "authDate": "2019-11-11",
      "fraudStatus": "1",
      "fraudType": "40",
      "comment": "по данной строке информация занесена не будет, только PAN недостаточно для внесения информации"
    },
    {
      "pan": "<PAN>",
       "arn": "<ARN>",
       "mti": "1240",
      "authDate": "2019-11-11",
      "fraudStatus": "3",
      "fraudType": "10",
      "comment": "по данной строке информация занесена не будет, несоотвествие типа мошенничества и статуса 3 и 10"
    },
      {
      "pan": "<PAN>",
       "arn": "<ARN",
       "mti": "1240",
      "authDate": "2019-11-11",
      "fraudStatus": "2",
      "fraudType": "99",
      "comment": "по данной строке информация занесена не будет, несоотвествие типа мошенничества и статуса 2 и 99"
    },
     {
      "pan": "<PAN",
       "arn": "<ARN>",
       "mti": "1240",
      "authDate": "2019-11-11",
      "fraudStatus": "1",
      "fraudType": "99",
      "comment": "по данной строке информация занесена не будет, несоотвествие типа мошенничества и статуса 1 и 99"
    }
  ]
}



An example of HTTP response

JSON
HTTP/1.1 200 OK
Cache-Control: no-cache
Pragma: no-cache
Content-Length: 192
Content-Type: application/json; charset=utf-8
Expires: -1
Server: Microsoft-IIS/8.5
X-AspNet-Version: 4.0.30319
X-Powered-By: ASP.NET
Date: Fri, 28 Feb 2020 11:24:14 GMT
{
   "success": true,
   "result": <идентификатор {id} для выполнения запроса информации об обработке записей GetPacketStatus>
}

Data types

ApiSiomPacketItem

Code Data type Description Comment
arn string ARN  
pan string PAN  
rrn string RRN  
mti string Message type identifier

1240 - Clearing message
0100 - Authorization message

authDate string Authorization date & time  
fraudStatus string Fraud status

1 - confirmed fraud
2 - security check 
3 - non-fraud

fraudType string Fraud type two-digit numeric code according to the SIOM fraud type codes list
comment string Additional information