Request for operation completion with the full pre-authorization amount, shopping cart (depositOrder)

The request used for debiting a pre-authorized order is depositOrder. This operation can be performed provided that the merchant has the corresponding permissions in the system.

Use the following URL to connect to the Test Service (WSDL):
https://3dsec.sberbank.ru/payment/webservices/merchant-ws?wsdl.

When orders are completed, the cart is passed in the element deposititems.

  • In the case of completing an order with a full pre-authorized amount, passing the cart data is optional.
  • The operation completion amount in the cart must not exceed the pre-authorized amount of the order.
  • When completing an order for an amount that differs from the amount of the pre-authorization (apart from passing the 0 value), the data about the cart of items must mandatory be passed.
  • Prices of all the items in the cart must be specified in the same currency (if the currency of items is to be specified) and must match the currency of the original order. For Sberbank «Spasibo» the order currency must be Russian rubles (643-RUB).
  • It is prohibited to pass in the cart new items, which are missing from the original order. A check is carried out whether given item in the request cart is present in the original order. The positionId, name, and itemCode must match. If at least one value does not coincide, it is considered that the line item is missing from cart in the registration order.
  • The value of the quantity element in the cart of the completion request must not exceed the value of the same parameter in the cart of the registration order request.
  • The itemAmount element value of the items block must not exceed the value of the same parameter in the original order.
  • A passed value of the quantity parameter is to be checked for each line item. If the value is too large or too small, the request will fail.
  • All the parameters of the cart are to be checked for meeting the required format (length).

If at least one of the above conditions is not met, the order completion request is considered incorrectly formed and the payment gateway returns an error.

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

  • A<n> – a sequence of Latin letters of length <n>;
  • A..<n> – a sequence of Latin letters with a length not exceeding <n>;
  • N<n> – a sequence of digits of length <n>;
  • N..<n> – a sequence of digits with a length not exceeding <n>;
  • AN<n> – a sequence of Latin letters and numbers of fixed length <n>;
  • AN.. <n> – a sequence of Latin letters and numbers with a length not exceeding <n>;
  • ANS<n> – a sequence of Latin letters, numbers and characters of fixed length <n>
  • ANS.. <n> – a sequence of Latin letters, numbers and characters with a length not exceeding <n>;
  • UTC – date and time, in this case: the date must be passed without specifying the time zone, Moscow time, for the SOAP protocol, the standard encoding xs: dateTime is used.

Request parameters

Name Type Mandatory Description

orderId

ANS36

Yes

Identifier of the order in the payment system. It is unique within the system. The identifier is missing if the order registration failed due to an error detailed in errorCode.

depositAmount

N..5

Yes

To complete the operation with the full pre-authorization amount, it is necessary to send the full amount of the order or 0. If the depositAmount parameter is not specified, the operation will also be completed with the full pre-authorization amount.

language

A2

No

Language code in accordance with ISO 639-1. If this parameter is not specified, it is considered that the language is Russian. An error message will be returned in this language.

If you do not specify the depositAmount parameter, completion will take place for the entire pre-authorized amount.

Response parameters

Name Type Mandatory Description

errorCode

N3

Yes

Error code.

errorMessage

AN..512

No

Error description in the language passed in the language parameter in the request.

Error codes

Value Description
0

The request has been processed without system errors.

5

The deposit amount exceeds the amount put on hold.

5

The deposit amount must be equal to zero or not less than one roble.

5

Access denied.

5

The user must change the password.

6

Wrong order number.

6

[orderId] is empty.

7

Payment must be in the correct state.

7

System error.

Examples

Request example

<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:mer="http://engine.paymentgate.ru/webservices/merchant">
   <soapenv:Header/>
   <soapenv:Body>
      <mer:depositOrder>
         <order language="ru" orderId="8c76c56b-426c-435d-a24c-1c0927dd6fca" depositAmount=" ">
            <!--Optional:-->
 
            <!--Zero or more repetitions:-->
            <params name=" " value=" "/>
         </order>
      </mer:depositOrder>
   </soapenv:Body>
</soapenv:Envelope>

Response example

<soap:Envelope xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/">
   <soap:Body>
      <ns1:depositOrderResponse xmlns:ns1="http://engine.paymentgate.ru/webservices/merchant">
         <return errorCode="0"/>
      </ns1:depositOrderResponse>
   </soap:Body>
</soap:Envelope>