Request for information about the result of an operation

In this document, the following data type conventions are used when describing request and response parameters:

string – string;
array – data array;
object – data object;
data – date;
boolean – boolean (logical) data type;
int. (integer) – integer data type;
amount – a numeric data type (amount).

Request parameters:

Parameter	Type	Description	Example
`mdOrder`	string	Order number in the payment gateway. Unique within the payment gateway.	906bf262-bd53-4ac7-983c-07127954681b
`transactionNumber`	string	A unique transaction number on the partner's side is required to maintain idempotence of transactions.	7654321DS

To make a request, you need to specify one parameter only.

Request format:

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>"
}

Response parameters:

Parameter	Type	Description	Example
`mdOrder`	string	Order number in the payment gateway. Unique within the payment gateway.	906bf262-bd53-4ac7-983c-07127954681b
`mdOrderStatus`	string	Current order status.	DEPOSITED
`transactionType`	string	Transaction type<t 0/>, the following values are possible: PURCHASE; TRANSFER.	PURCHASE
`transactionWay`	string	The payment method.	Apple Pay
`transactionDate`	date	Date of transaction.	07.09.2017 17:43:57.768
`transactionDetails`	object	The object of the transaction information.
`source`	object	Data object of the transfer sender.
`card`	object	Data object with information about the source card.
`maskedPan`	string	Masked card number.	4111111199
`binding`	string	Card identifier.	ABC14E0F13AB4542AA9D10E81F74A6E3
`target`	object	Object of the transfer recipient's data, if there is data about the recipient.
`card`	object	Recipient's card data object.
`maskedPan`	string	Masked card number.	5111111199
`binding`	string	Card identifier.	87414E0F13AB4542AA9D10E81F74A6E3
`amount`	object	Data object about the amount of payment.
`transactionAmount`	amount	Payment amount in minor currency units (61.00 rubles = 6100).	6100
`transactionFee`	amount	The amount of the commission for payment in minor currency units (1.00 rubles = 100).	200
`currency`	string	Payment currency.	643
`requestId`	string	Request identifier.	gbhjnkme-rdcfgv-hbjnkm-7689ui-okp3ew
`status`	string	Indication of the status of the request processing result	SUCCESS

Response format:

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>"
}

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

Request for information about the result of an operation