Предварительно у вашего сайта должна быть настроена корзина или карточки товара с формой перехода к оплате. После этого вы можете настраивать как серверные интеграции от Креатиум, так и подключать сторонний платежный сервис. Как настроить карточки товара или корзину вы можете изучить в нашей инструкции:
На Creatium есть возможность с помощью прослойки в виде кода подключить любую платежную систему. Для этого добавлен специальный тип платежной системы:
В его настройках указывается только URL-адрес ендпоинта, с которым происходит взаимодействие.
Таким образом любую платежную систему можно подключить с помощью посредника.
Схема работы
Работа ендпоинта начинается в тот момент, когда пользователь начинает процесс покупки, и отправляет форму в корзине или с карточки товара, с подключенной оплатой.
В этот момент 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: Юмани
Это простой пример интеграции Юмани (не Юкассы, обратите внимание) для приема платежей физическим лицам.
Ендпоинт получает запрос, формирует форму, и возвращает ее ответом. Далее этот же ендпоинт получает уведомление об успешной оплате от Юмани, для этого в настройках кошелька Юмани была указана ссылка на ендпоинт с GET-параметром, чтобы отличать запрос от запросов Creatium.
Пример 2: Life Pay
Это пример интеграции c платежным сервисом Life Pay, ендпоинт является универсальным и используется только ссылка на него
