Оплата банковской картой товаров и услуг через интернет может осуществляться с
передачей полных карточных реквизитов в платёжный шлюз, с помощью связок, а
также с использованием внешних платёжных систем.
Магазин может использовать одностадийный или двухстадийный механизм принятия платежа.
Магазину для интеграции с платёжным шлюзом доступны различные схемы подключения в зависимости от механизма (одностадийный или двухстадийный) и инструмента оплаты. В текущем документе представлено описание следующих схем подключения.
Раздел Платёж на свободную сумму описывает сценарий оплаты с использованием страницы платежа на свободную сумму, размещённой в платёжном шлюзе.
В зависимости от схемы взаимодействия, по которой работает магазин, требуется использовать определённый набор запросов. В описаниях перечисленных выше сценариев указано на каком шаге сценария какой запрос должен использоваться, а также дана ссылка на раздел со спецификацией запроса.
Возможные интерфейсы взаимодействия с платёжным шлюзом представлены в следующем разделе.
Магазин для взаимодействия с платёжным шлюзом может использовать один из интерфейсов – интерфейс на WebService-ах или REST.
Для авторизации обращения магазина к системе платёжного шлюза в любом запросе со стороны магазина должны быть приведены имя и пароль магазина, полученные при регистрации магазина в системе. Подробная информация об авторизации обращений представлена ниже.
Реализация взаимодействия через интерфейс на Web-Service
Описание (WSDL) сервиса находится на тестовом сервере, который доступен без ограничений.
Значения имени и пароля передаются в формате, описанном в рамках спецификации WS-Security, тип авторизации userName token. Заголовок при такой авторизации будет выглядеть примерно так (см. ниже).
<wsse:Security xmlns:wsse="http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-wssecurity-
secext-1.0.xsd" xmlns:wsu="http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-
%20wssecurity-utility-1.0.xsd">
<wsse:UsernameToken wsu:Id="UsernameToken-87">
<wsse:Username>aa</wsse:Username>
<wsse:Password Type="http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-username-
token-profile-1.0#PasswordText">123456</wsse:Password>
</wsse:UsernameToken>
</wsse:Security>
Если в ответе на запрос errorCode (Код ошибки) = 0, это означает, что запрос был обработан платежным шлюзом без системных ошибок. При этом errorCode не отображает статус заказа.
Для получения статуса заказа следует использовать запрос getOrderStatus или getOrderStatusExtended (один из этих методов обязательно должен быть реализован при интеграции ТСП с платёжным шлюзом).
Реализация взаимодействия через интерфейс REST
Взаимодействие реализуются как HTTP обращения методом POST на определенные URL.
Результат обработки запроса возвращается в виде JSON объекта. Например: {"errorCode":"12","errorMessage":"Empty amount"}
Значения имени и пароля передаются в следующих параметрах (см. таблицу ниже).
| Название | Тип | Обязательность | Описание |
|---|---|---|---|
| password | AN..30 | да | Пароль магазина, полученный при подключении |
| userName | AN..30 | да | Логин магазина, полученный при подключении |
Все текстовые поля должны иметь кодировку Юникод (UTF-8).
Спец-символы в REST запросе должны быть экранированы в соответствии с URL-кодом. Таблица символов расположена по следующему адресу: https://wm-school.ru/html/html_url_acsii.html. Например, пароль qwe?rt%y должен передаваться в виде qwe%0Frt%25y.
Если в ответе на запрос errorCode (Код ошибки) = 0, это означает, что запрос был обработан платежным шлюзом без системных ошибок. При этом errorCode не отображает статус заказа.
Для получения статуса заказа следует использовать запрос getOrderStatus.do или getOrderStatusExtende.do (один из этих методов обязательно должен быть реализован при интеграции ТСП с платёжным шлюзом).
При регистрации магазина представителю предоставляется пара логин/пароль, которая должна использоваться в протоколах.
Описание тестового сервиса (WSDL) находится по адресу:
https://tws.egopay.ru/api/ab/webservices/merchant-ws?wsdl
Описание тестового сервиса (WSDL) по СБП находится по адресу:
https://tws.egopay.ru/api/ab/webservices/sbpc2b-ws?wsdl
URL для доступа к методам REST: