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

Запрос создания связки без проведения платежа (createBindingNoPayment)

Для создания связки без проведения платежа используется запрос createBindingNoPayment.

Для использования этого метода у вас должны быть соответствующие права в системе.

В настоящем документе при описании параметров запросов и ответов используются следующие обозначения типов данных:

  • A<n> – последовательность латинских букв длины <n>;
  • A..<n> – последовательность латинских букв длиной, не превышающей <n>;
  • N<n> – последовательность цифр длины <n>;
  • N..<n> – последовательность цифр длиной, не превышающей <n>;
  • AN<n> – последовательность латинских букв и цифр фиксированной длины <n>;
  • AN..<n> – последовательность латинских букв и цифр длиной, не превышающей <n>;
  • ANS<n> – последовательность латинских букв, цифр и символов фиксированной длины <n>
  • ANS..<n> – последовательность латинских букв, цифр и символов длиной, не превышающей <n>;
  • UTC – дата и время, при этом: дата должна быть передана без указания часового пояса, время московское, для протокола SOAP используется стандартная кодировка xs:dateTime.

Параметры запроса

Название Тип Обязательно Описание

clientId

ANS..255

Да

Номер (идентификатор) клиента в системе магазина. Используется для реализации функциональности связок.

cardholderName

AS..26

Да

Имя держателя карты латиницей, если доступно. Длина поля ограничена 26 символами (латинские буквы, точка, пробел).

expiryDate

N6

Да

Срок истечения действия карты в формате ГГГГММ. Указан только после оплаты заказа.

pan

N12…19

Да

Номер платёжной карты.

При указании в запросе параметра seToken этот параметр не обязателен к передаче.

additionalParameters

Не актуально

Нет

Дополнительные параметры заказа, которые сохраняются для просмотра из личного кабинета продавца. Для каждого дополнительного параметра следует использовать блок entry, в который входят следующие вложенные параметры.

Название Тип Описание

key

Строка

Имя дополнительного параметра.

value

ANS..2000

Значение дополнительного параметра - до 2000 символов.

Ниже представлен пример использования. 

<entry>
    <key>parameter_1</key>
    <value>value_1</value>
</entry>
<entry>
    <key>parameter_2</key>
    <value>value_2</value>
</entry>

Если у продавца настроена фискализация, при указании в качестве дополнительных параметров email (адрес электронной почты покупателя) и/или phone (номер сотового телефона покупателя) эти параметры в первую очередь используются для отправки фискального чека.

В параметре запрещено передавать зарезервированные имена (в случае их передачи заказ может быть отклонен):

  • sbrf_spasibo:amount_bonus
  • sbrf_sbermiles:amount_bonus
  • loyaltyId
  • overridenClientId

Параметры ответа

Название Тип Обязательно Описание

errorCode

N..2

Да

Код ошибки.

errorMessage

AN..512

Нет

Описание ошибки на языке, переданном в параметре language в запросе.

bindingId

AN..255

Нет

Идентификатор связки созданной при оплате заказа или использованной для оплаты. Присутствует только если магазину разрешено создание связок.

cardholderName

AS..26

Нет

Имя держателя карты латиницей, если доступно. Длина поля ограничена 26 символами (латинские буквы, точка, пробел).

clientId

ANS..255

Нет

Номер (идентификатор) клиента в системе магазина. Используется для реализации функциональности связок.

expiryDate

N6

Нет

Срок истечения действия карты в формате ГГГГММ. Указан только после оплаты заказа.

maskedPan

N..19

Нет

Маскированный номер карты, которая использовалась для оплаты.

Коды ошибок

Значение Описание
0 Обработка запроса прошла без системных ошибок
1 В запросе не передан обязательный параметр или передан некорректный обязательный параметр
1 Запрещён доступ к данной функции
1 Карты платежной системы CUP не поддерживаются при создании связок
1 У продавца отсутствует разрешение на использование карт JCB
1 У продавца отсутствует разрешение на использование карт AMEX
1 У продавца отсутствует разрешение на использование карт Diners Club
1 У продавца отсутствует разрешение на использование карт Discover
1 Неверный номер карты
1 Срок действия карты неверен
1 Имя держателя карты неверно
1 Идентификатор клиента неверен
1 Недопустимая длина ключей дополнительных параметров
1 Недопустимая длина значений дополнительных параметров
1 Системная ошибка
1 Связка уже создана

Пример запроса

<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:mer="http://engine.paymentgate.ru/webservices/merchant">
   <soapenv:Header/>
   <soapenv:Body>
      <mer:createBindingNoPayment>
         <request>
            <pan>4111111111111111</pan>
            <cardholderName>ANOTHER ONE</cardholderName>
            <clientId>753160</clientId>
            <expiryDate>201912</expiryDate>
         </request>
      </mer:createBindingNoPayment>
   </soapenv:Body>
</soapenv:Envelope>

Пример ответа

<soap:Envelope xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/">
   <soap:Body>
      <ns1:createBindingNoPaymentResponse xmlns:ns1="http://engine.paymentgate.ru/webservices/merchant">
         <return>
            <bindingId>eee7b63f-de82-47b3-9bb3-769878e7e06a</bindingId>
            <cardholderName>ANOTHER ONE</cardholderName>
            <clientId>753160</clientId>
            <errorCode>0</errorCode>
            <expiryDate>201912</expiryDate>
            <maskedPan>411111**1111</maskedPan>
         </return>
      </ns1:createBindingNoPaymentResponse>
   </soap:Body>
</soap:Envelope>