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



Request for making payment by binding

The request used for making a payment by binding is ''paymentOrderBinding.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.

mdOrder

ANS..36

Yes

Order number in the payment gateway. Unique within the payment gateway.

bindingId

AN..255

Yes

Identifier of the binding created earlier.

language

A2

No

Language in the ISO 639-1 encoding. If the language is not specified, the default language defined in the store settings is used.

ip

ANS..39

Yes

IP-address of the buyer. IPv6 is supported in all requests (up to 39 characters).

cvc

N3

No

This parameter is mandatory, if Can process payments without confirmation of CVC is not selected for a Merchant.

email

ANS..40

No

Customer's email address.

loyaltyId

ANS..*

No

Loyalty program identifier. The sbrf_spasibo value should be used.

pointsAmount

N..20

No

The number of bonus points to be debited.

Response parameters:

Name Type Mandatory Description

redirect

ANS..*

No

On a successful response. In the case of a payment without the need for authentication to the ACS – URL to which redirect is performed after the payment. In case of a 3D-Secure payment, the URL to return to ACS.

info

ANS..*

No

On a successful response. Result of a payment attempt. The available values are presented below.

  • Your payment has been processed, redirecting..
  • Payment declined. Check the entered data and that there are enough funds on the card and repeat the operation. Redirecting…
  • Sorry, the payment cannot be processed. Redirecting…
  • Payment declined. Please contact the Merchant. Redirecting…
  • Payment declined. Contact the bank that issued the card. Redirecting…
  • Operation is impossible. Cardholder authentication completed unsuccessfully. Redirecting…
  • No connection to the bank. Try again later. Redirecting…
  • The data entering period has expired. Redirecting…
  • No response from the bank. Try again later. Redirecting…

errorCode

ANS..3

Yes

Error code.

errorMessage

AN..512

No

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

acsUrl

AN..512

No

Redirect address to the address of the ACS server.

paReq

AN..512

No

Request for the payer authentication.

termUrl

AN..512

No

URL to redirect the payer to after authentication.

Error codes (the ErrorCode field):

Value Description
0 The request has been processed without system errors.
1 It is necessary to specify CVC2/CVV2 because the merchant does not have a permission to process payments without CVC.
1 Incorrect format of CVC.
1 Incorrect language.
2 The binding is not found.
2 Order with this number is not found.
5 Access denied.
5 The user who is calling the service must change the password.
7 System error.

An example of the POST request: 

mdOrder=eb49300c-95b7-4dcd-9739-eee6c61f2ac4&bindingId=308042e8-2b28-484a-811e-f786c9776c3b&cvc=123&loyaltyId=sbrf_spasibo&pointsAmount=12000

An example of a success response for an SSL payment: 

{"redirect":"http://ya.ru?orderId=eb49300c-95b7-4dcd-9739-eee6c61f2ac4","info":"Your payment has been processed, redirecting...","errorCode":0}

An example of a success response for a 3D-Secure payment: 

{"info":"Your payment has been processed, redirecting...","acsUrl":"https://test.paymentgate.ru/acs/auth/start.do","paReq":"eJxVUdtugkAQ/RXCOy7LRdQMa2ixKU28pGrfyTICqSzKpcW/765AbR8mOWcyOWfmDCy74qx9YVXn\npfB1OjF1DQUvk1ykvn48vBgzfcngkFWI4R55WyGDNdZ1nKKWJ74+TVz05tPE8NyZbThOfDJmFjcN\ni55Mz+MJzu25zmAXvOOVwWDEpM/EAjJSqVjxLBYNg5hfn6INcyxvappABgoFVlHIPCA9ABEXyPb4\nhWKVp1mzyQUCuTeBl61oqhubOjaQkUBbnVnWNJcFId5sPuFlAUT1gDy8d61CtdTo8oStw+C7r5W5\nCVNZx9v6ENmyfCBqApK4QWaZ1KXUcjVqLVx7Ycu77n2IC2XOqDqjh3BRDsGj/5eDDLeS2Y+bjwyw\nu5QC5YRU/sVAHts+v6rceCODyfbb7m3bfmzD22dnlycaFHF+DGl0y6hK8z6kFHMZity7l1QEiJIh\nw6PI8GOJ/v3+BweMtyE=","termUrl":"https://test.paymentgate.ru:443/testpayment/rest/finish3ds.do","errorCode":0}

An example of a response containing an error: 

{"error":"Access denied","errorCode":5,"errorMessage":"Access denied"}