Агентский API Оплата: различия между версиями
(→См. также) |
|||
| Строка 45: | Строка 45: | ||
WSDL находится по адресу: http://CLIENT_DOMAIN/wsdev/wsdl.php?version=1.0&for=PaymentInitialization | WSDL находится по адресу: http://CLIENT_DOMAIN/wsdev/wsdl.php?version=1.0&for=PaymentInitialization | ||
| + | На данный момент метод доступен для платежных шлюзов Юнителлер и Рапида. | ||
Для получения результата необходим параметр — «OrderId» — Id забронированного заказа, который необходимо оплатить. | Для получения результата необходим параметр — «OrderId» — Id забронированного заказа, который необходимо оплатить. | ||
| Строка 50: | Строка 51: | ||
Данный запрос позволяет получить список платёжных шлюзов, через которые есть возможность оплатить указанный заказ. | Данный запрос позволяет получить список платёжных шлюзов, через которые есть возможность оплатить указанный заказ. | ||
По каждому платёжному шлюзу возвращается следующая информация: | По каждому платёжному шлюзу возвращается следующая информация: | ||
| + | * id способа оплаты | ||
* имя платежного шлюза | * имя платежного шлюза | ||
* дополнительную наценку, которая добавляется к заказу при проведении оплаты через данный шлюз | * дополнительную наценку, которая добавляется к заказу при проведении оплаты через данный шлюз | ||
| Строка 104: | Строка 106: | ||
<Gateways> | <Gateways> | ||
<Gateway> | <Gateway> | ||
| + | <PaymentMethodId>?</PaymentMethodId> | ||
| + | <!--PaymentMethodId - ID способа оплаты. Необходим при использовании запроса SelectPayment (см. ниже)--> | ||
<GatewayName>?</GatewayName> | <GatewayName>?</GatewayName> | ||
<!--GatewayName — имя платежного шлюза. Например: Uniteller --> | <!--GatewayName — имя платежного шлюза. Например: Uniteller --> | ||
| Строка 164: | Строка 168: | ||
<Gateways> | <Gateways> | ||
<Gateway> | <Gateway> | ||
| + | <PaymentMethodId>1075</PaymentMethodId> | ||
<GatewayName>Uniteller</GatewayName> | <GatewayName>Uniteller</GatewayName> | ||
<PaymentCharge Currency="RUB">81.54</PaymentCharge> | <PaymentCharge Currency="RUB">81.54</PaymentCharge> | ||
| Строка 170: | Строка 175: | ||
<UrlToCatch>http://CLIENT_DOMAIN/poffice__bookinfo?&booking_id=276965</UrlToCatch> | <UrlToCatch>http://CLIENT_DOMAIN/poffice__bookinfo?&booking_id=276965</UrlToCatch> | ||
<!--Пример ссылки--> | <!--Пример ссылки--> | ||
| + | </Gateway> | ||
| + | <Gateway> | ||
| + | <PaymentMethodId>1079</PaymentMethodId> | ||
| + | <GatewayName>Rapida</GatewayName> | ||
| + | <PaymentCharge Currency="RUB">123</PaymentCharge> | ||
| + | <RedirectUrl/> | ||
| + | <UrlToCatch xsi:nil="true"/> | ||
</Gateway> | </Gateway> | ||
</Gateways> | </Gateways> | ||
| Строка 180: | Строка 192: | ||
</div> | </div> | ||
</div> | </div> | ||
| + | |||
| + | '''Примечание:''' если параметр RedirectUrl в ответе отсутствует, для инициализации оплаты необходимо использовать метод SelectPayment. | ||
== См. также == | == См. также == | ||
Версия 17:50, 20 января 2015
Содержание
Подключение
Это сервис внутри Nemo, который предназначен для выполнения различных операций, относящихся к оплате заказов.
Для подключения к данной веб-службе необходимо открыть доступ нужному пользователю. Это можно сделать в разделе «Администрирование» ⇨ «Веб-служба. Авторизация».
После добавления пользователя, ему будут присвоены Номер (ClientId) и API ключ клиента, которые нужно использовать для подключения.
Фиксация оплаты внешним запросом
Сервис предназначен для приема информации о получении оплаты и простановки статуса «Оплачено» для определенного заказа.
Сервис вызывается следующим образом: http://CLIENT_DOMAIN/index.php?go=payment/bill
Подпись запроса
Подпись sig сверяется c md5($booking_id.$secret)
$booking_id - Id заказа в системе Nemo,
$secret - значение настройки в разделе «Администрирование» ⇨ «Настройки агентства» ⇨ «Ключ безопасности для сервиса выставления оплаты и получения XML выгрузки»
Пример:
Если booking_id: 263330 ключ безопасности: 12345 То sig=md5(26333012345) = a439a4492131f4b866ed1a17d018d3a6
Для фиксации оплаты получается такая ссылка: http://CLIENT_DOMAIN/index.php?go=payment/bill&booking_id=263330&sig=a439a4492131f4b866ed1a17d018d3a6
Дополнительная информация в статье Интеграция
Получение списка доступных способов оплаты
WSDL находится по адресу: http://CLIENT_DOMAIN/wsdev/wsdl.php?version=1.0&for=PaymentInitialization На данный момент метод доступен для платежных шлюзов Юнителлер и Рапида.
Для получения результата необходим параметр — «OrderId» — Id забронированного заказа, который необходимо оплатить.
Данный запрос позволяет получить список платёжных шлюзов, через которые есть возможность оплатить указанный заказ. По каждому платёжному шлюзу возвращается следующая информация:
- id способа оплаты
- имя платежного шлюза
- дополнительную наценку, которая добавляется к заказу при проведении оплаты через данный шлюз
- URL, перенаправляющий пользователя непосредственно на страницу оплаты через данный платёжный шлюз
- в случае отправки запроса с мобильной платформы может дополнительно возвращается URL, на который происходит перенаправление пользователя для оплаты
Общий формат запроса / ответа
Запрос
Ответ
Примеры использования
Запрос
Ответ
Примечание: если параметр RedirectUrl в ответе отсутствует, для инициализации оплаты необходимо использовать метод SelectPayment.
