Запрос проведения оплаты по связке

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

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

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.

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

Название	Тип	Обязательно	Описание
`userName`	AN..30	Да	Логин магазина, полученный при подключении.
`password`	AN..200	Да	Пароль магазина, полученный при подключении.
`mdOrder`	ANS..36	Да	Номер заказа в платёжном шлюзе. Уникален в пределах платёжного шлюза.
`bindingId`	AN..255	Да	Идентификатор связки, созданной ранее.
`language`	A2	Нет	Язык в кодировке ISO 639-1. Если не указан, будет использован язык, указанный в настройках магазина как язык по умолчанию.
`ip`	ANS..39	Нет	IP-адрес покупателя. IPv6 поддерживается во всех запросах (до 39 символов).
`cvc`	N3	Нет	Этот параметр обязателен, если для продавца не выбрано разрешение Может проводить оплату без подтверждения CVC.
`email`	ANS..40	Нет	Адрес электронной почты покупателя.
`loyaltyId`	ANS..*	Нет	Идентификатор программы лояльности. Следует использовать значение sbrf_spasibo.
`pointsAmount`	N..20	Нет	Количество бонусных баллов к списанию.

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

Название	Тип	Обязательно	Описание
`redirect`	ANS..*	Нет	При успешном ответе. В случае платежа без необходимости аутентификации на ACS – URL, на который производится переадресация после платежа. В случае 3DS-платежа – URL для возврата с ACS.
`info`	ANS..*	Нет	При успешном ответе. Результат попытки оплаты. Возможные значения представлены ниже. Ваш платёж обработан, происходит переадресация… Операция отклонена. Проверьте введённые данные, достаточность средств на карте и повторите операцию. Происходит переадресация… Извините, платёж не может быть совершён. Происходит переадресация… Операция отклонена. Обратитесь в магазин. Происходит переадресация… Операция отклонена. Обратитесь в банк, выпустивший карту. Происходит переадресация… Операция невозможна. Аутентификация держателя карты завершена неуспешно. Происходит переадресация… Нет связи с банком. Повторите позже. Происходит переадресация… Истёк срок ожидания ввода данных. Происходит переадресация… Не получен ответ от банка. Повторите позже. Происходит переадресация…
`errorCode`	N..2	Да	Код ошибки.
`errorMessage`	AN..512	Нет	Описание ошибки на языке, переданном в параметре `language` в запросе.
`acsUrl`	AN..512	Нет	Адрес перенаправления на адрес сервера ACS.
`paReq`	AN..512	Нет	Запрос аутентификации плательщика.
`termUrl`	AN..512	Нет	Ссылка перенаправления плательщика после аутентификации.

Коды ошибок (поле success):

Значение	Описание
0	Обработка запроса прошла без системных ошибок.
1	Необходимо указать CVC2/CVV2, поскольку у мерчанта нет разрешения на проведение оплаты без CVC.
1	Неверный формат CVC.
1	Неверный язык.
2	Связка не найдена.
2	Заказ с таким номером не найден.
5	Доступ запрещён.
5	Пользователь, осуществляющий вызов сервиса, должен изменить свой пароль.
7	Системная ошибка.

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

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

Пример успешного ответа при SSL-платеже:

{"redirect":"http://ya.ru?orderId=eb49300c-95b7-4dcd-9739-eee6c61f2ac4","info":"Ваш платёж обработан, происходит переадресация...","errorCode":0}

Пример успешного ответа при 3DS-платеже:

{"info":"Ваш платёж обработан, происходит переадресация...","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}

Пример ответа с ошибкой:

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