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



Request for order payment by binding (paymentOrderBinding)

The request used for making a payment by binding is paymentOrderBinding.

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

Request parameters

Name Type Mandatory Description

mdOrder

ANS..36

Yes

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

bindingId

AN..255

Yes

The identifier of the previously created binding. Can only be used if the merchant has permission to work with bindings. If this parameter is passed in the given request, it means that:
1. The given order can be paid only using a binding;
2. The payer will be redirected to the payment page on which only entering CVC is required.

params

See column with the description.

Yes

Additional tag with the attributes for passing additional parameters. The fields for additional information and its subsequent storage. These fields can be submitted for processing by the bank for further display in the registers. By default, the order number orderNumber and its description orderDescription are passed to the bank for processing (no more than 99 characters, «%» (percentage), «+» (plus),  «\r» (carriage return) and «\n» (line feed) are prohibited for using).

Enabling the functionality is possible upon agreement with the Bank during the integration period. To pass N parameters, a request must contain N params tags, where the name attribute contains the parameter name and value attribute contains its value:

Name Type Description
Name

name

Type

AN..20

Type2

ANS..255

Type3

A7

Type4

ANS..100

Description
REST

Name of the additional parameter.

REST Online Lending

The attribute name, always takes the value of mdOrder.

WS

Name of the additional parameter.

Spasibo

Name or the description of an item in any format.

Spasibo2

Name of the parameter describing the details of a line item

ANS..255

Name of the additional parameter.

value

AN..1024

The value of the additional parameter is up to 1024 characters.

It is forbidden to pass reserved names in the parameter (if they are passed, the order may be rejected):

  • sbrf_spasibo:amount_bonus
  • sbrf_sbermiles:amount_bonus
  • loyaltyId

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.

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.

errorTypeName

String

No

Parameter required by the front page to define the error text. Mandatory in case of unsuccessful payment.

Possible values can be viewed here

acsUrl

AN..512

No

Redirect address to the address of the ACS server.

paReq

AN..512

No

Request for the payer authentication.

Error codes

Error code Error text
0

The request has been processed without system errors.

1

[mdOrder] is empty.

1

[bindingId] is empty.

2

The binding is not found.

2

Access denied.

5

The user must change the password.

5

All payment attempts were used.

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:paymentOrderBinding>
          <order mdOrder="9213bc5f-5d5b-43d6-a408-b6b93cdde992" bindingId="ca91a4ab-b6d4-495d-b606-8fb0114e679e" language="ru" ip="127.0.0.1" cvc="123" email=" ">
             <!-Zero or more repetitions:->
             <params name=" " value=" "/>
          </order>
       </mer:paymentOrderBinding>
    </soapenv:Body>
 </soapenv:Envelope>

Response example

<soap:Envelope xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/">
   <soap:Body>
      <ns1:paymentOrderBindingResponse xmlns:ns1="http://engine.paymentgate.ru/webservices/merchant">
         <return errorCode="0" info="Your payment has been processed, redirecting is taking place..." redirect="http://example.ru?orderId=9213bc5f-5d5b-43d6-a408-b6b93cdde992"/"/>
      </ns1:paymentOrderBindingResponse>
   </soap:Body>
</soap:Envelope>