Request for a list of operations performed

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
`dateFrom`	date	Start date of the period.	07.09.2017 17:43:57.768
`dateTo`	date	End date of the period.	07.09.2017 17:43:57.768
`responseType`	string	Type of information requested. The possible values are: payment – payment operations; transfer – transfer operations; vcard – card issue operations; loyalty – operations with «Spasibo» bonuses; change – change operations.	`payment,transfer`
`local`	boolean	Specifying the request for operations within the current application only, the following values are possible: true false	`true`

Request format:

POST /api/transactions/ HTTP/1.1

Host: 3dsec.sberbank.ru/sbersafe

Content-Type: application/json

Authorization: <accessToken>

Accept: application/json; version=1.0

Content-Length: <content-lenght>

 

{

  "dateFrom":"<dateFrom>",

  "dateTo":"<dateTo>",

  "responseType":"<responseType>",

  "local":<true|false>

}

Response parameters:

Parameter	Type	Description	Example
`transactions`	array	Array of data about operations performed.
`mdOrder`	string	Order number in the payment gateway. Unique within the payment gateway.	C2BC84C12AD6438DAA0D87517C7AE187
`transactionNumber`	string	A unique transaction number on the partner's side is required to maintain idempotence of transactions.	7654321DS
`transactionDate`	date	Date of transaction.	07.09.2017 17:43:57.768
`transactionType`	string	Transaction type<t 0/>, the following values are possible: PURCHASE; TRANSFER.	PURCHASE
`transactionWay`	string	The payment method.	Apple Pay
`amount`	object	Data object about the amount of payment.
`transactionAmount`	amount	Payment amount in minor currency units (61.00 rubles = 6100).	6100
`currency`	string	Payment currency.	643
`partner`	object	Data object on the place of the operation.
`merchantLogin`	string	The partner identifier you received when registering in the payment gateway.	spasibo_mp
`merchantInfo`	string	Human readable description of the operation initiator partner.	«Spasibo» mobile app
`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
 
{
  "transactions": [
      {
        "mdOrder": "<uuid>",
        "transactionNumber": "<transactionNumber>",
        "transactionDate":"<transactionDate>",
        "transactionType":"<transactionType>",
        "transactionWay":"<transactionWay>",
        "amount":{
           "transactionAmount":"<transactionAmount>",
           "currency":"<currency>"
           }
        "partner":{
           "merchantLogin":"<merchantLogin>",
           "merchantInfo":"<merchantInfo>"
           }
      },
      {
        "mdOrder": "<uuid>",
        "transactionNumber": "<transactionNumber>",
        "transactionDate":"<transactionDate>",
        "transactionType":"<transactionType>",
        "transactionWay":"<transactionWay>",
        "amount":{
           "transactionAmount":"<transactionAmount>",
           "currency":"<currency>"
           }
        "partner":{
           "merchantLogin":"<merchantLogin>",
           "merchantInfo":"<merchantInfo>"
           }
      }
   ],
  "requestId":"<requestId>",
  "status": "<status>"
}

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

Request for a list of operations performed