Гид по интеграции Checkout¶
Надеемся, у вас уже есть общее понимание работы системы и зачем вам нужно использовать Checkout. Теперь разберемся с Checkout API и особенностями взаимодействия с ним, а также вкратце ознакомимся с возможными способами интеграции Checkout на сайте, в приложении, в веб-магазине или сервисах типа Smart TV.
Checkout взаимодействует с аккаунтами в рамках всей экосистемы Cublox.
Экосистема Cublox¶
Страница оплаты (Checkout) интегрируется с REST API Cublox на уровне сервера и затем не требует дополнительной интеграции на стороне клиента. API обмениваются сообщениями с продуктами Cublox и взаимодействуют между собой с помощью нескольких объектов с данными.
Схема взаимодействия¶
Субъекты взаимодействия¶
Платежный виджет¶
Платежный виджет встраивается на страницу оплаты и позволяет легко инициировать платеж. Виджет взаимодействует с Public API для получения списка доступных платежных методов, создания инвойса платежа, а затем — получения статуса.
Checkout¶
Cublox Checkout — готовое фронтенд-приложение, который использует Public API для визуализации доступных платежных сервисов и создания инвойса. После — в зависимости от заданного процесса оплаты — происходит перенаправление клиента на конечный платежный шлюз. И наконец, Checkout перенаправляет клиента после оплаты на страницу со статусом платежа, а затем обратно, на сайт продавца.
Public API (публичный API)¶
Public API отвечает за предоставление платежных сервисов, платежных методов, доступных для аккаунтов пользователей (продавцов услуг), за создание инвойсов и получение общей информации о статусе платежа.
Private API (приватный API)¶
Private API предоставляет полную функциональность для управления инвойсами, получения полной информации о платеже, при необходимости — отмены или возвращению средств платежа.
Callbacks¶
Callbacks отвечают за доставку моментальных уведомлений при смене статуса платежа или выплаты. Уведомление может быть также использовано на сервере продавца для запуска дальнейшей бизнес-логики обработки оплаченного заказа.
На сайте/в приложении продавца¶
На стороне продавца на шаге оплаты заказа создается инвойс платежа. Это может происходить в платежном виджете или с помощью простого перенаправления (ссылки на оплату) на Checkout с необходимыми параметрами платежа для оплаты заказа.
В CMS продавца¶
Здесь происходит управление заказом, инициация платежа и обработка уведомлений о смене статуса платежа.
Как это работает¶
Технически, Checkout — сопровождающая услуга для Cublox Commerce, который использует платежный шлюз Cublox, и может быть определен как Платежный провайдер. С помощью API-интеграции создается инвойс платежа, затем Checkout используется, чтобы пользователь мог совершить платеж по данным инвойса.
Полный платежный процесс задействует три сервиса Cublox:
- Checkout API — для отображения инвойса платежа клиенту.
- Public API — для интеграции создания инвойса.
- Private API — для обработки платежа или возврата уже созданного платежа.
Дальше¶
Подробнее о методах интеграции: с помощью платежного виджета и ссылки на оплату.