Техническая интеграция с PayOnline - методы, инструменты, вопросы и ответы

Что такое техническая интеграция и зачем она нужна?
Что это?
Техническая интеграция - это процесс доработки и настройки сайта мерчанта для последующего успешного взаимодействия с системой PayOnline и приема платежей.
Зачем ее делать?
Без корректной технической интеграции мерчант не сможет принимать платежи на своем сайте и своевременно получать информацию о совершенных на сайте оплатах.

Типы интеграции
Существует два основных типа интеграции мерчанта с PayOnline:
Standart
Host2Host
Каждый мерчант самостоятельно определяет для себя подходящий способ интеграции.
Метод «Standart» использует 98%+ мерчантов.
Метод «Host2Host» может реализовать только мерчант, у которого есть PCI DSS.

Метод интеграции «Standart»
Этот метод является основным - его использует подавляющее большинство мерчантов. Он подходит всем – сайтам и приложениям.
Почему?
Он простой и безопасный.
Он подходит для сайтом и приложений на всех платформах.
Для сайтов на CMS есть готовые модули (подробно про CMS – далее).
Что важно?
Ввод данных карты происходит на нашей стороне, на защищенной платежной странице.
Мерчант не несет ответственность за безопасность платежных данных.

Работа мерчанта и PayOnline при интеграции по методу «Standard»
Мерчант формирует ссылку на оплату из параметров, которые позволяют нашей системе идентифицировать платеж.
Ссылка шифруется с помощью специального Secure Key (ключа безопасности), который известен только мерчанту и PayOnline.
Плательщик переходит по этой ссылке на платежную форму PayOnline и совершает оплату.
PayOnline обрабатывает платеж и отправляет мерчанту результат оплаты:
Если оплата успешная – на Return URL.
Если оплата не успешная – на Fail URL.
Также может оправляться на e-mail.
Проще говоря.
Мерчант «учит» свой сайт передавать нам набор параметров в зашифрованной ссылке, отправлять по этой ссылке плательщика и получать от нас результат платежа для дальнейшей обработки заказа.

Параметры, которые нам передает мерчант
MID
Номер заказа
Сумма платежа
Валюта платежа
Результат шифрования строки приватным ключом
Также мерчант может передавать дополнительные параметры.
Из параметров формируется ссылка на оплату, по которой плательщик переходит на нашу платежную форму:
https://secure.payonlinesystem.com/ru/payment/?MerchantId=123&OrderId=123&Amount=100.00&Currency=RUB&SecurityKey=123&dopparametr=12345

CMS модули – упрощенная интеграция по методу «Standart»
Что такое CMS?
CMS – это платформа для создания интернет-магазинов и любых других сайтов. Пользователь собирает сайт из готовых блоков – модулей, в том числе – модулей платежных сервисов.
С помощью CMS можно создать сайт без помощи разработчиков (как это недавно сделала Анна Иванова для нашей финансовой институции в Чехии). Вот почему в мире так много сайтов на CMS.
Для каких CMS есть готовые модули PayOnline?
Модули PayOnline реализованы для 19 различных CMS.
Самые популярные из них – 1C-Битрикс, Joomla, Drupal, WordPress.
Большинство наших моделей доступны бесплатно.

Метод интеграции «Host2Host»
Этот метод используют самые большие и самые технологичные мерчанты. Чтобы его использовать, мерчанту нужен PCI DSS.
В чем основное отличие?
Плательщик заполняет форму на сайте мерчанта. То есть мерчант принимает данные банковских карт на своей стороне – и пересылает их в PayOnline для обработки без открытия платежной формы.
Как еще называется этот метод?
В нашем API этот метод называется Auth.ъ
Что такое PCI DSS?
Это международный стандарт безопасности в сфере платежных карт. У PayOnline он самого высокого уровня – первого. Мерчантам достаточно четвертого.
Но даже четвертый получить непросто и стоит это не дешево.

API - это способ упростить интеграцию по методу «Host2Host»
Что такое API?
API – это набор готовых методов для прямого обращения в наш сервис, использование которых определяется и реализуется мерчантом самостоятельно.
Для чего он нужен?
Программистам мерчанта не приходится самостоятельно реализовывать различные способы взаимодействия с API. Они используют готовые методы для различных форматов обмена данными и настраивают их под себя.
Основные методы API:
Auth (Host2Host): мерчант получает данные плательщика самостоятельно, после чего передает данные карты в наш сервис и получает ответ по проведенной транзакции.
3DS: в ответ на метод Auth, мерчант может получить сообщение, что карта подписана на 3Ds. В таком случае мерчант использует метод 3Ds.
Rebill: с помощь данного метода, мерчант может проводить Rebill (автоплатежи, регулярные списания).

SDK – еще один способ упростить интеграцию
Что такое SDK?
API – это «библиотеки» для ускоренной и упрощенной интеграции с PayOnline.
Кому нужен SDK?
SDK нужен для быстрой интеграции приема платежей через PayOnline в мобильные приложения на iOS, Windows, Android (SDK для Android не является универсальным).
Также он подходит для самописных сайтов (.php) и самописных сервисов (.net).
Для чего он нужен?
Программистам мерчанта становится сильно проще жить.
SDK – это готовый комплект средств разработки, который позволяет провести интеграцию по методам «Standard» или «Host2Host» в считанные часы.

Где что лежит?
Документация по интеграции по методам «Standart» и «Host2Host» доступна в Wiki в разделе «Документы» -> «Документация для мерчантов».
Модули для CMS находятся на сайте компании в разделе «Модули для CMS».
Все существующие SDK также размещены на сайте в разделе «Интеграция».
Самая свежая версия справочника API также доступна на Wiki вот по этой ссылке.

Переходим к практике:
ТОП популярных вопросов
+
любимых ошибок в ходе интеграции

Вопрос 1: Что такое приватный ключ, где мне его взять?
Приватный ключ (Private Security Key) – это набор символов, позволяющий мерчанту зашифровать ссылку («Standart»)или запрос («Host2host»), защитив тем самым передаваемые данные. Взять можно в ЛК мерчанта.
Вопрос 2: Какие готовые решения у вас есть, где их взять?
У нас есть готовые решения для различных CMS, SDK для различных платформ. Вы можете ознакомиться с ними на сайте www.payonline.ru (разделы «Интеграция» и «Модули для CMS»).
Вопрос 3: Могу ли я получать данные карты и передавать их вам самостоятельно?
Да, можете. Для этого у нас есть API и метод Auth («Host2Host»). Важно - вам нужен сертификат PCI DSS для обработки данных карты на Вашей стороне.

Вопрос 4: Каким образом я могу получать статус платежа на свой сайт?
У нас есть функционал Callback. После включения данного функционала, на указанную вами страницу сайта будет направляться основная информация по прошедшей транзакции.
Вопрос 5: У меня сайт написан на редком языке программирования (я использую не популярную CMS) - как я могу с вами интегрироваться?
Процесс интеграции с нами универсален. Вы можете самостоятельно реализовать нужное Вам решение, основываясь на нашей документации. Если у вас нет программиста, вы можете нанять фрилансера.
Вопрос 6: На вашем сайте есть модули, которые на данный момент устарели. Могу ли я их использовать и какие могут возникнуть проблемы?
В большинстве случаев, обновление CMS не вносит достаточно глобальные изменения в логику взаимодействия. В случае, если CMS выпустила глобальное обновление и модуль перестал работать корректно - мы стараемся в кратчайшие сроки обновить модуль.