Перейти до змісту

Гид по интеграции Checkout

Надеемся, у вас уже есть общее понимание работы системы и зачем вам нужно использовать Checkout. Теперь разберемся с Checkout API и особенностями взаимодействия с ним, а также вкратце ознакомимся с возможными способами интеграции Checkout на сайте, в приложении, в веб-магазине или сервисах типа Smart TV.

Checkout взаимодействует с аккаунтами в рамках всей экосистемы Cublox.

Экосистема Cublox

Страница оплаты (Checkout) интегрируется с REST API Cublox на уровне сервера и затем не требует дополнительной интеграции на стороне клиента. API обмениваются сообщениями с продуктами Cublox и взаимодействуют между собой с помощью нескольких объектов с данными.

Checkout: схема взаимодействия

Схема взаимодействия

Интеграция Checkout

Субъекты взаимодействия

Платежный виджет

Платежный виджет встраивается на страницу оплаты и позволяет легко инициировать платеж. Виджет взаимодействует с 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:

  1. Checkout API — для отображения инвойса платежа клиенту.
  2. Public API — для интеграции создания инвойса.
  3. Private API — для обработки платежа или возврата уже созданного платежа.

Дальше

Подробнее о методах интеграции: с помощью платежного виджета и ссылки на оплату.