Для руководителя продукта

Для банков и финансовых платформ

Интеграция в платформу

CertaRail проверяет запрос пользователя, применяет правила допуска и сохраняет решения. Команда платформы выбирает интерфейс и передаёт данные. Отношения с клиентом, расчёты, исполнение и хранение активов остаются у ответственных участников.

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

Демонстрация использует тестовые данные. Доступность backend и внешнего исполнения подтверждается отдельно для выбранной интеграции.

Оценка интеграции

Что проверяет команда платформы

Это план оценки сценария, а не прогресс вашей платформы. Результат — выбранная модель интерфейса и требования к тестовой интеграции.

  1. Задача

    Зафиксировать задачу партнёра и границу ответственности.

    Результат: одна задача платформы и ответственный за неё.

  2. Модель интерфейса

    Выбрать способ подключения по реальной доступности.

    Результат: модель интерфейса, среда и список ограничений.

  3. Демонстрация

    Показать путь пользователя без внешнего исполнения.

    Результат: согласованный UX и ожидаемые состояния.

  4. Тестовая среда

    Воспроизвести выбранный сценарий на тестовых данных.

    Результат: повторяемый запрос, событие и запись результата.

  5. Техническая проверка

    Проверить контракт, результат и восстановление после ошибок.

    Результат: материалы для технической проверки.

  6. Тестовый запуск

    Согласовать тестовый запуск и критерии приёмки.

    Результат: сценарий, ответственные, приёмочные испытания и условия запуска.

Задача платформы

Что нужно вашему продукту

Выберите задачу для вашего продукта. Конкретный режим подключения определим после того, как зафиксируем UX, события, ограничения и границы ответственности.

01

Сохранить полный контроль над собственным интерфейсом

Партнёр сам проектирует экраны, тексты, навигацию и поддержку, а CertaRail возвращает разрешённые состояния и evidence для отображения.

02

Получать изменения статуса без ручной сверки

Система партнёра принимает безопасные события, удаляет дубли по стабильному event ID и при пропуске сверяется с текущим статусом. Внешняя HTTPS-доставка требует production-активации.

03

Добавить путь покупки прямо в существующий экран

Партнёр сохраняет свою навигацию и размещение, а изолированный checkout проводит пользователя через сумму, проверку, статус и receipt. Сейчас этот контур подтверждён только в synthetic sandbox.

04

Перевести пользователя в готовый путь и вернуть обратно

Партнёр создаёт короткоживущую сессию, направляет пользователя в hosted flow и возвращает его только на заранее разрешённый адрес. Итог подтверждается статусом или событием, а не URL-параметром.

05

Передать только разрешённое намерение и ограничения

Backend партнёра задаёт opaque reference, разрешённый BUY-сценарий, лимиты, активы и адреса возврата; браузер не может сменить tenant, клиента или расширить эти условия.

Модель интерфейса

Размещение интерфейса и обмен данными

Сравните размещение интерфейса, работу вашей команды и доступность тестовой среды.

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

Три модели интерфейса используют 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Актуальный статус не опубликован. Готовность и условия активации пока не подтверждены.

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

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

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

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

03 · DEMO

Пользователь видит следующий шаг, а не внутренний backend-код.

В production этот путь потребует подключённых KYC/KYB, pricing, payment, execution и custody-провайдеров. Сейчас сайт демонстрирует состояния и контрактную границу без фиктивной операции.

Посмотреть демо
DEMO CHECKOUTSANDBOX
₿
Тестовый активDEMO-BTC
100 000 TEST-RUB
Курс
DEMO · не рыночный
Комиссия
Не рассчитана
Срок
Не является офертой
Текущий статусНужно подтвердить личность

DEMO REQUIRED · действие недоступно в статической иллюстрации

Тестовая среда

Подготовка тестовой интеграции

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

01

Зафиксировать scope

Один use case, выбранный integration mode, test subjects и запрещённые внешние эффекты.

РЕАЛИЗОВАНО
02

Воспроизвести lifecycle

Команда, idempotent replay, status, event, timeline и receipt проверяются на одном frozen payload.

РЕАЛИЗОВАНО
03

Согласовать exit criteria

Owner review фиксирует обязательные проверки, blockers и пакет доказательств до pilot.

ТРЕБУЕТ АКТИВАЦИИ

Техническая проверка

Результаты технической проверки

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

RESTКанонический OpenAPI 3.1
СобытияКанонический AsyncAPI 3.1
Внешние вызовы по умолчанию0
Внешний monetary / asset эффектNOT_EXECUTED
  1. 01

    Заморозить scope и входные данные

    Use case, mode, opaque subject reference и idempotency key входят в проверяемый сценарий.

  2. 02

    Выполнить контрактный сценарий

    OpenAPI/AsyncAPI boundary, status и safe projection проверяются на согласованном payload.

  3. 03

    Сопоставить evidence

    Decision, events, timeline и receipt должны описывать один и тот же lifecycle.

  4. 04

    Повторить recovery path

    Retry сохраняет idempotency key, а authoritative status снимает неоднозначность.

  5. 05

    Зафиксировать внешнюю границу

    external_calls=0, monetary=false и production_enforceable=false остаются частью proof.

  6. 06

    Подтвердить критерии pilot

    Partner UAT, owners и activation gates требуют отдельного acceptance record.

Участники

Распределение ответственности

Роли в партнёрском пользовательском сценарии
КонтурПартнёрCertaRailВнешний участник
Пользовательский интерфейсВладелец UXКонтракт и demo reference—
Допуск и лимитыПередаёт factsPolicy + evidenceДополнительный screening по договору
КотировкаПоказывает пользователюТолько interface boundaryPricing provider — не подключён
Платёж и исполнениеОпределяет маршрутНе исполняетБанк / брокер / venue
Хранение и доставкаВыбирает модельНе хранит ключиCustodian / wallet provider
СверкаПринимает статусEvidence и observationsВозвращает подтверждение

Роли в партнёрском пользовательском сценарии

Пользовательский интерфейс

Партнёр
Владелец UX
CertaRail
Контракт и demo reference
Внешний участник
—

Допуск и лимиты

Партнёр
Передаёт facts
CertaRail
Policy + evidence
Внешний участник
Дополнительный screening по договору

Котировка

Партнёр
Показывает пользователю
CertaRail
Только interface boundary
Внешний участник
Pricing provider — не подключён

Платёж и исполнение

Партнёр
Определяет маршрут
CertaRail
Не исполняет
Внешний участник
Банк / брокер / venue

Хранение и доставка

Партнёр
Выбирает модель
CertaRail
Не хранит ключи
Внешний участник
Custodian / wallet provider

Сверка

Партнёр
Принимает статус
CertaRail
Evidence и observations
Внешний участник
Возвращает подтверждение

FAQ

Вопросы перед подключением

Можно встроить готовый widget?

Embedded checkout исполняется в локальном SANDBOX с origin allowlist и короткоживущим scoped credential. Production package, compatibility policy и distribution process ещё не приняты.

Есть hosted checkout?

Да, локальный SANDBOX поддерживает hosted, embedded и headless режимы, session token, immutable quote, Deal Core evidence и receipt. Реальные pricing, payment, venue и custody effects отключены.

Как приходят события?

Kafka получает события из transactional outbox. В checkout SANDBOX реализованы tenant-scoped Webhook Inbox, создание, rotation и revoke subscription, тестовые подписанные события, delivery journal и bounded/manual retry. Внешний production HTTPS transport и UAT остаются заблокированы.

Как получить sandbox?

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

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

Согласуйте сценарий, участников и результаты испытаний. Общий порядок работ описан в разделе подключения.

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