Request for order payment completion

The method used for completion is autoCompletion.do.

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

userName

AN..30

Yes Login issued to the Store upon integration with the Payment Gateway.

password

AN..30

Yes Password issued to the Store upon integration with the Payment Gateway.

orderId

ANS36

Yes

Identifier of the order in the payment system. It is unique within the system. Missing if order registration failed due to an error detailed in ErrorCode.

compositeCompletionAmount

N..20

Yes

The amount to be debited, consisting of the amount in money and the amount of points. The amount can be equal to or less than the order remaining amount.

If zero is passed in this parameter, completion will occur for the entire pre-authorized amount.

Response parameters:

Name Type Mandatory Description

errorCode

ANS..3

Yes

Error code.

errorMessage

AN..512

Yes

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

pcId

AN..512

No

Loyalty processing transaction identifier.

operation

AN..512

No

Operation type, the following values are possible:

  • PAYMENT;
  • AWARD;
  • REVERSE;
  • REFUND_PAYMENT;
  • REFUND_AWARD.

transactionId

AN..512

No

The identifier of the transaction in the payment gateway.

amount

N..20

No Amount in points.

successful

AN..512

No

A feature of the success of the operation, the following values are possible:

  • true (successful);
  • false (unsuccessful).

Request example: 

https://3dsec.sberbank.ru/payment/rest/autoCompletion.do?userName=login&password=password&orderId=94e86702-d37a-44dc-b953-36f75f80507b&compositeCompletionAmount=90000

Response example: 

{"operations":[{"pcId":2699110,"operation":"REFUND_PAYMENT","amount":20,"successful":true,"transactionId":"1642"},{"pcId":2699111,"operation":"REFUND_AWARD","amount":10180,"successful":true,"transactionId":"1643"}],"errorCode":"0"}