Для разработчика

Интерфейс, данные и ответственность

Варианты интеграции

Сравните, где работает пользователь, кто поддерживает интерфейс и что требуется от вашей команды. REST API и события обеспечивают обмен данными для выбранной модели.

Что потребуется от вашей команды

Три модели интерфейса используют API для команд и сверки. Тестовая доступность проверяется отдельно от наличия контракта.

Распределение работы для Hosted, Embedded и Headless
Практический вопросHostedEmbeddedHeadless
Где работает пользовательНа отдельной странице CertaRailВо встроенном экране внутри вашего продуктаВ вашем собственном интерфейсе
Кто меняет интерфейсCertaRail в пределах согласованной поставкиCertaRail меняет встроенный экран; партнёр — окружающий интерфейсВаша продуктовая команда
Что делает сервер партнёраСоздаёт сессию, открывает короткоживущую ссылку и сверяет итогСоздаёт ограниченную сессию, задаёт разрешённый origin и проверяет итогПередаёт факты, вызывает операции и отображает каждое состояние
Какие данные нужныТестовые параметры сессии и разрешённый URL возвратаТестовые параметры сессии и origin вашего приложенияФакты для проверки, ссылки на объекты и ключ повтора запроса
Как узнавать результатBackend читает статус; возврат браузера сам по себе не подтверждает итогСобытие iframe уведомляет UI; backend подтверждает итог через APIОтвет API и чтение статуса; события дополняют сверку
Что можно посмотреть сейчасСинтетический показ страницы и опубликованный контрактСинтетический показ встроенного пути и опубликованный контрактУчебное решение, инструкция по запуску и опубликованный контракт
Что согласовать до пилотаТестовую среду, срок сессии, домены, URL возврата и ответственныхТестовую среду, origin, политику встраивания и контракт сообщенийТестовую среду, маппинг фактов, состояния, доступ и обработку повторов

Доступ к API и внешнее исполнение не следуют из выбора интерфейса. Для актуального статуса среды откройте подробности выбранного варианта.

Где должен работать пользователь?

Выбор можно оставить открытым. Начните с демонстрации и сравните объём работы команды в таблице.

Подготовить запрос с помощью в выборе

Сравнить все варианты

Подробности выбранной модели

Выберите, где работает пользователь. REST API и события связывают все три модели с вашим backend.

Одна операция · общая модельDEMO_SESSION_001
Интерфейс пользователяHosted pageКонтроль CertaRail
Backend партнёраSession → status
CertaRailДопуск · решение · evidence
Отдельная страница CertaRail. Возврат на сайт партнёра не подтверждает результат операции.

Схема интеграции · синтетический ID. Внешнее исполнение не показано: sandbox evidence его не подтверждает.

Hosted

СТАТУС НЕДОСТУПЕН. Актуальный статус не опубликован. Готовность и условия активации пока не подтверждены.

Как этот вариант выглядит для партнёра и пользователя

  1. 01

    Сервер партнёра создаёт сессию с ограниченным сроком и ссылку на страницу CertaRail.

  2. 02

    Браузер открывает CertaRail и получает защищённую cookie с ограниченными правами.

  3. 03

    Пользователь проходит предварительную проверку, проверяет расчёт, подтверждает действие и видит статус.

  4. 04

    Браузер возвращается на разрешённый адрес; сервер сверяет статус или событие.

Результат примера: Возврат браузера сам по себе не подтверждает итог. Учебная запись не доказывает исполнение оператором или завершение расчётов.

Полный статус, среда и условия активации

Фактическая среда

Среда · Hosted

Среда выполнения не подтверждена. Подробности доступны ниже.

Активное environmentНе подтверждена
Требования среды и технические детали

Выбор показывает требования к среде. Работа приложения, доступ и внешнее исполнение не меняются.

Контекст проверки: HOSTED_SANDBOX · Hosted Sandbox. Активное environment: UNKNOWN · FAIL CLOSED.
HOSTED_SANDBOX · Hosted SandboxVERIFIED · NOT PUBLISHED
Тип данных
NON_PRODUCTION_TEST_ONLYDocumented sandbox retention and deletion policy with tenant isolation; no production retention or residency claim is inherited.
Внешние вызовы
ЗАПРЕЩЕНЫEffects may persist inside the isolated hosted sandbox, but no external provider, customer system, mailbox, regulator, bank, chain, or custody target is read or changed.
Деньги / активы
РЕАЛЬНАЯ СТОИМОСТЬ ЗАПРЕЩЕНАHosted ledgers, quotes, payments, fills, balances, and assets are non-monetary synthetic facts; no real funding, custody, settlement, withdrawal, or transfer is permitted.
Credential type
HOSTED_SANDBOX_ONLYSandbox secrets use the hosted secret boundary, are never returned after issuance, and never enter source, logs, evidence, or browser storage.
Production blockers
СТАТУС НЕДОСТУПЕННет свежей owner-approved revision (NO_FRESH_PUBLISHED_REVISION). Нулевое число blockers не предполагается.

Hosted

Hosted

Реализация
СТАТУС НЕДОСТУПЕН
Доступная среда
NOT PUBLISHEDАктуальный статус не опубликован. Готовность и условия активации пока не подтверждены.

Проверенная граница реализации

Актуальный статус не опубликован. Готовность и условия активации пока не подтверждены.

Что нужно закрыть до активации

Актуальный статус не опубликован. Готовность и условия активации пока не подтверждены.

Обмен данными и отдельные возможности

REST API передаёт команды и читает подтверждённое состояние. События уведомляют об изменениях. AssetLink связывает отдельный актив с операционным контуром.

Контракт REST API для всех моделей
Kafka / WebhooksТранспорт событий, подписи и сверка

Kafka / Webhooks

СТАТУС НЕДОСТУПЕН. Актуальный статус не опубликован. Готовность и условия активации пока не подтверждены.

Как этот вариант выглядит для партнёра и пользователя

  1. 01

    Тестовая операция сохраняет изменение состояния вместе с неизменяемой записью.

  2. 02

    Очередь исходящих событий передаёт локальное событие либо сохраняется подписанное сообщение о завершении.

  3. 03

    Партнёр исключает повторы по идентификатору события и проверяет подпись, когда она есть.

  4. 04

    При пропуске события или неоднозначном ответе сервер читает текущий статус через API.

Результат примера: Статус DELIVERED подтверждает проверку подписанного сообщения внутри процесса. Доставка по HTTPS и приём системой партнёра требуют отдельного подтверждения.

Полный статус, среда и условия активации

Фактическая среда

Среда · Kafka / Webhooks

Среда выполнения не подтверждена. Подробности доступны ниже.

Активное environmentНе подтверждена
Требования среды и технические детали

Выбор показывает требования к среде. Работа приложения, доступ и внешнее исполнение не меняются.

Контекст проверки: HOSTED_SANDBOX · Hosted Sandbox. Активное environment: UNKNOWN · FAIL CLOSED.
HOSTED_SANDBOX · Hosted SandboxVERIFIED · NOT PUBLISHED
Тип данных
NON_PRODUCTION_TEST_ONLYDocumented sandbox retention and deletion policy with tenant isolation; no production retention or residency claim is inherited.
Внешние вызовы
ЗАПРЕЩЕНЫEffects may persist inside the isolated hosted sandbox, but no external provider, customer system, mailbox, regulator, bank, chain, or custody target is read or changed.
Деньги / активы
РЕАЛЬНАЯ СТОИМОСТЬ ЗАПРЕЩЕНАHosted ledgers, quotes, payments, fills, balances, and assets are non-monetary synthetic facts; no real funding, custody, settlement, withdrawal, or transfer is permitted.
Credential type
HOSTED_SANDBOX_ONLYSandbox secrets use the hosted secret boundary, are never returned after issuance, and never enter source, logs, evidence, or browser storage.
Production blockers
СТАТУС НЕДОСТУПЕННет свежей owner-approved revision (NO_FRESH_PUBLISHED_REVISION). Нулевое число blockers не предполагается.

Kafka / Webhooks

Kafka / Webhooks

Реализация
СТАТУС НЕДОСТУПЕН
Доступная среда
NOT PUBLISHEDАктуальный статус не опубликован. Готовность и условия активации пока не подтверждены.

Проверенная граница реализации

Актуальный статус не опубликован. Готовность и условия активации пока не подтверждены.

Что нужно закрыть до активации

Актуальный статус не опубликован. Готовность и условия активации пока не подтверждены.

Статус реализации и условия активации
01

Реестр возможностей

Актуальный статус не опубликован. Готовность и условия активации пока не подтверждены.

СТАТУС НЕДОСТУПЕН

Подключение рабочего контура

Условия перехода к рабочему контуру

Для рабочего контура нужны ответственные участники, договоры, доступы, защищённая сеть и результаты испытаний. Порядок работ общий для всех моделей интеграции.

Этапы подключения платформы