Запрос сведений о результате операции

В настоящем документе при описании параметров запросов и ответов используются следующие обозначения типов данных:

string – строка;
array - массив данных;
object - объект данных;
data - дата;
boolean - булевый (логический) тип данных;
int. (integer) - целочисленный тип данных;
amount - числовой тип данных (сумма).

Параметры запроса:

Параметр	Тип	Описание	Пример
`mdOrder`	string	Номер заказа в платёжном шлюзе. Уникален в пределах платёжного шлюза.	906bf262-bd53-4ac7-983c-07127954681b
`transactionNumber`	string	Уникальный номер транзакции на стороне партнёра, необходим для поддержания идемпотентности транзакций.	7654321DS

Для проведения запроса достаточно указать только один параметр.

Формат запроса:

POST /api/transactions/find HTTP/1.1
Host: 3dsec.sberbank.ru/sbersafe
Content-Type: application/json
Authorization: <accessToken>
Accept: application/json; version=1.0
Content-Length: <content-lenght>

{
  "mdOrder": "<mdOrder>",
  "transactionNumber":"<transactionNumber>"
}

Параметры ответа:

Параметр	Тип	Описание	Пример
`mdOrder`	string	Номер заказа в платёжном шлюзе. Уникален в пределах платёжного шлюза.	906bf262-bd53-4ac7-983c-07127954681b
`mdOrderStatus`	string	Текущий статус заказа.	DEPOSITED
`transactionType`	string	Тип транзакции, возможны следующие значения: PURCHASE; TRANSFER.	PURCHASE
`transactionWay`	string	Способ оплаты.	Apple Pay
`transactionDate`	date	Дата проведения транзакции.	07.09.2017 17:43:57.768
`transactionDetails`	object	Объект информации о транзакции.
`source`	object	Объект данных отправителя перевода.
`card`	object	Объект данных с информацией о карте источнике.
`maskedPan`	string	Маскированный номер карты.	4111111199
`binding`	string	Идентификатор карты.	ABC14E0F13AB4542AA9D10E81F74A6E3
`target`	object	Объект данных получателя перевода, в случае наличия данных о получателе.
`card`	object	Объект карточных данных получателя.
`maskedPan`	string	Маскированный номер карты.	5111111199
`binding`	string	Идентификатор карты.	87414E0F13AB4542AA9D10E81F74A6E3
`amount`	object	Объект данных о сумме оплаты.
`transactionAmount`	amount	Сумма оплаты в минорных единицах валюты (61.00 рублей = 6100).	6100
`transactionFee`	amount	Сумма комиссии по оплате в минорных единицах валюты (1.00 рублей = 100).	200
`currency`	string	Валюта оплаты.	643
`requestId`	string	Идентификатор запроса	gbhjnkme-rdcfgv-hbjnkm-7689ui-okp3ew
`status`	string	Указание на статус результата обработки запроса	SUCCESS

Формат ответа:

HTTP/1.1 200 OK
Content-Type: application/json
Content-Length: <content-lenght>
Cache-Control: no-store
 
{
  "mdOrder": "<mdOrder>",
  "mdOrderStatus": "<mdOrderStatus>",
  "transactionNumber": "<transactionNumber>",
  "transactionType": "<transactionType>",
  "transactionWay":"<transationWay>",
  "transactionDate": "<transactionDate>",
  "transactionDetails": {
     "source": {
       	"card": {
            "paymentSystem":"<paymentSystem>",
    		"maskedPan": "<maskedPan>"
			},
		"binding": ""
        },
     "target": {
    	"card": {
            "paymentSystem":"<paymentSystem>",
    		"maskedPan": "<maskedPan>"
			},
		"binding": ""
      },
     "amount":{
        "transactionAmount": <amount>,
        "transactionFee": <fee>,
        "currency": "<currency>",
      }
   },
  "requestId": "<requestId>",
  "status": "<status>"
}

Инструменты страницы

Запрос сведений о результате операции