Предварительно у вашего сайта должна быть настроена корзина или карточки товара с формой перехода к оплате. После этого вы можете настраивать как серверные интеграции от Креатиум, так и подключать сторонний платежный сервис. Как настроить карточки товара или корзину вы можете изучить в нашей инструкции:
Как добавить и настроить корзину
На Creatium есть возможность с помощью прослойки в виде кода подключить любую платежную систему. Для этого добавлен специальный тип платежной системы:
В его настройках указывается только URL-адрес ендпоинта, с которым происходит взаимодействие.
Суть интеграции кратко: Creatium работает с ендпоинтом, как если бы он и был платежной системой, а уже сам ендпоинт осуществляет интеграцию с настоящей платежной системой и обеспечивает взаимодействие с ней.
Таким образом любую платежную систему можно подключить с помощью посредника.
Схема работы
Работа ендпоинта начинается в тот момент, когда пользователь начинает процесс покупки, и отправляет форму в корзине или с карточки товара, с подключенной оплатой.
В этот момент Creatium отправляет запрос с данными платежа, формат которого полностью повторяет формат вебхука при отправке заявок. Ендпоинт уже сам разбирается с платежной системой, и в ответ он может вернуть либо ссылку на страницу оплаты, полученную от платежной системы, либо HTML-форму, которая должна быть отправлена, чтобы был совершен переход на страницу платежной системы. Creatium перенаправляет пользователя по ссылке, пользователь оплачивает покупку. Платежная система уведомляет ендпоинт о том, что был успешно совершен платеж. Как именно она уведомляет - это зависит от платежной системы. Получив уведомление от платежной системы, ендпоинт должен отправить POST-запрос на специальный адрес https://api.creatium.io/integration-payment/third-party-payment, в формате application/json, и передать 2 параметра: payment_key и status. payment_key был отправлен еще в первом запросе от Creatium, а status может быть или "succeeded”, или “canceled” или “failed”. Для например возвратов платежей, мы добавили возможность смены статуса succeeded на canceled.
Пример 1: Юмани
Ссылка: https://www.napkin.io/n/f886676ed4a54681
Это простой пример интеграции Юмани (не Юкассы, обратите внимание) для приема платежей физическим лицам. Ендпоинт получает запрос, формирует форму, и возвращает ее ответом. Далее этот же ендпоинт получает уведомление об успешной оплате от Юмани, для этого в настройках кошелька Юмани была указана ссылка на ендпоинт с GET-параметром, чтобы отличать запрос от запросов Creatium.
Пример 2: Life Pay
Ссылка: https://www.napkin.io/n/b627c22fa070457f
Это пример интеграции c платежным сервисом Life Pay, ендпоинт является универсальным и используется только ссылка на него
