Проблематика
Если вы не нашли в списке доступных к подключение ПС, вы можете собственными силами подключить любую другую ПС, используя протокол взаимодействия с сервисами Опентао.
Общие сведения
Опентао предоставляет протокол, позволяющий Контрагенту интегрировать способы оплаты, недоступные клиентам Опентао, в систему заказов и учета движения средств.
Общее описание протокола
Диаграмма последовательности взаимодействия всех участников платежа.
1. Пример взаимодействия Плательщик, ПС, Контрагнет, Опентао при проведении платежа.
1. Плательщик иницализирует оплату.
2-4. Сайт контрагента запрашивает способы оплаты в Опентао метод GetPaymentModes и показывает плательщику.
5. Плательщик выбирает способ оплаты и заполняет платежные данные, т.к. сумма платеж и др.
6. Сайт Контрагента запрашивает данные системы учета Опентао для инициаиализации платежа в ПС с помощью метода GetPaymentParameters
где PaymentForm
Параметр | Описание | |
---|---|---|
RequestUrl | Адрес оповещения сервиса, который используется в шаге 15 | |
RequestMethod | Способ отправки запроса на адрес оповещения | GET/POST |
PaymentFormParameter - платежный параметр, являющийся по сути KeyValuePair
Параметр | Описание | |||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
Name | Имя параметра |
| ||||||||||||
Value | Значение |
8. Контрагент на основе данных, полученных на шаге 7, формирует платежную форму с учетом требования ПС.
9. По данным, полученным из платежной формы, ПС формирует контракт, отправляет его плательщику и ждет подтверждения оплаты.
10. Плательщик подтверждает платеж.
11. ПС принимает и проверяет платеж.
12. ПС возвращает в браузер плательщика ответ - страницу с сообщением об успехи/неудачи платежа.
2. Пример взаимодействия ПС, Контрагент, Опентао при оповещении о платеже.
13. ПС уведомляет Контрагента о совершенном платеже
14. Контрагент адаптирует данные, полученные в шаге 13, к параметрам оповещения Опентао.
15. Контрагент уведомляет Опентао о совершенном платеже.
Необходимо передать нижеследующие параметры на адрес оповещения RequestUrl методом RequestMethod (получены от Опентао на 7 шаге), используя транспорт HTTP.
instanceKey | |
orderId | |
paymentId | |
usertId | |
amount | |
currency | |
signature |
16. Опентао проверяет параметры оповещение. В случае когда все проверки пройдены - зачисляет средства на счет плательщика.
17. Опенато подтверждает Контрагенту получение оповещения о платеже
18. Контрагент подтверждает ПС получение оповещения о платеже
3. Описание данных
3.Таблица данных
3.1 Платежные параметры
Параметр | Описание | Возможное значение | Примечание |
---|---|---|---|
instanceKey | Идентификатор контрагента/клиента в системе Опентао | ||
orderId | Идентификатор заказа для оплаты | Присутствует если пользователь оплачивает заказ. Отсутствует при пополнении счета | |
paymentId | Идентификатор платежа во внутренней системе биллинга Опентао | ||
usertId | Идентификатор пользователя Опентао | ||
amount | Сумма платежа | ||
currency | Цифровой код валюты платежа в формате ISO 4217 | 643 - RUB | http://en.wikipedia.org/wiki/ISO_4217 |
signature | Цифровая подпись зашифрованная по алгоритму MD5 | 32 шестнадцатеричных символа, в верхнем регистре | |
description | Описание платежа |