Hosted
- Путь пользователя
- Отдельная страница CertaRail и возврат в ваш продукт
- Ваша часть
- Создание сессии, данные клиента, проверка результата
- Проверка
- Сценарий перехода и подтверждение статуса
Для разработчикаДалее: Встраивание в продукт партнёра
INTEGRATION OPTIONS · VERIFIED STATUS
Три способа встроить контроль операций.
Hosted открывает отдельный путь CertaRail, Embedded встраивает его в ваш продукт, Headless оставляет интерфейс под вашим управлением. Проверка правил и доказательства связывают каждый вариант.
Другие способы начать
Интерфейс и ответственность
1. Пользовательский путь
Выберите, где работает пользователь. REST API и события связывают все три модели с вашим backend.
Одна операция · общая модель
DEMO_SESSION_001Интерфейс пользователяHosted pageКонтроль CertaRail
Backend партнёраSession → status
CertaRailДопуск · решение · evidence
Схема интеграции · синтетический ID. Внешнее исполнение не показано: sandbox evidence его не подтверждает.
Hosted
СТАТУС НЕДОСТУПЕН. Актуальный статус не опубликован. Готовность и условия активации пока не подтверждены.
ПРИМЕР ПОЛЬЗОВАТЕЛЬСКОГО ПУТИ
Как этот вариант выглядит для партнёра и пользователя
- 01
Backend партнёра создаёт short-lived session и hosted start URL.
- 02
Browser переходит в CertaRail и обменивает token на scoped HttpOnly cookie.
- 03
Пользователь проходит preflight, quote, confirm и bounded status polling.
- 04
Browser возвращается на allowlisted URL; backend сверяет status или событие.
Граница обещания: Return URL не является authoritative результатом, а sandbox receipt не доказывает provider execution или settlement.
Полный статус, среда и условия активации
Фактическая среда
Environment status · HostedСреда выполнения не подтверждена. Подробности доступны ниже.
Требования среды и технические детали
Выбор показывает требования к среде. Работа приложения, доступ и внешнее исполнение не меняются.
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
- Implementation state
- СТАТУС НЕДОСТУПЕН
- Доступное environment
- NOT PUBLISHEDАктуальный статус не опубликован. Готовность и условия активации пока не подтверждены.
ЧТО РАБОТАЕТ
Проверенная граница реализации
Актуальный статус не опубликован. Готовность и условия активации пока не подтверждены.
PRODUCTION BLOCKERS
Что нужно закрыть до активации
Актуальный статус не опубликован. Готовность и условия активации пока не подтверждены.
Embedded
СТАТУС НЕДОСТУПЕН. Актуальный статус не опубликован. Готовность и условия активации пока не подтверждены.
ПРИМЕР ПОЛЬЗОВАТЕЛЬСКОГО ПУТИ
Как этот вариант выглядит для партнёра и пользователя
- 01
Backend партнёра создаёт session и получает одноразовый embedded start URL.
- 02
Приложение монтирует origin-bound iframe внутри своего экрана.
- 03
Пользователь проверяет и подтверждает synthetic quote в изолированном flow.
- 04
Host получает safe event, а backend подтверждает итог через status/receipt.
Граница обещания: COMPLETED в iframe означает завершённый synthetic sandbox contour — не списание денег, покупку или доставку актива.
Полный статус, среда и условия активации
Фактическая среда
Environment status · EmbeddedСреда выполнения не подтверждена. Подробности доступны ниже.
Требования среды и технические детали
Выбор показывает требования к среде. Работа приложения, доступ и внешнее исполнение не меняются.
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 не предполагается.
Embedded
Embedded
- Implementation state
- СТАТУС НЕДОСТУПЕН
- Доступное environment
- NOT PUBLISHEDАктуальный статус не опубликован. Готовность и условия активации пока не подтверждены.
ЧТО РАБОТАЕТ
Проверенная граница реализации
Актуальный статус не опубликован. Готовность и условия активации пока не подтверждены.
PRODUCTION BLOCKERS
Что нужно закрыть до активации
Актуальный статус не опубликован. Готовность и условия активации пока не подтверждены.
REST API
СТАТУС НЕДОСТУПЕН. Актуальный статус не опубликован. Готовность и условия активации пока не подтверждены.
ПРИМЕР ПОЛЬЗОВАТЕЛЬСКОГО ПУТИ
Как этот вариант выглядит для партнёра и пользователя
- 01
Backend партнёра создаёт constrained session с idempotency key.
- 02
CertaRail проверяет выбор, допуск и лимиты, затем формирует synthetic quote.
- 03
Интерфейс партнёра показывает разрешённый следующий шаг и safety status.
- 04
Backend читает authoritative status, events и receipt/evidence.
Граница обещания: Ответ API подтверждает только sandbox decision и evidence CertaRail — не банковское, биржевое или custody-исполнение.
Полный статус, среда и условия активации
Фактическая среда
Environment status · REST APIСреда выполнения не подтверждена. Подробности доступны ниже.
Требования среды и технические детали
Выбор показывает требования к среде. Работа приложения, доступ и внешнее исполнение не меняются.
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 не предполагается.
REST API
REST API
- Implementation state
- СТАТУС НЕДОСТУПЕН
- Доступное environment
- NOT PUBLISHEDАктуальный статус не опубликован. Готовность и условия активации пока не подтверждены.
ЧТО РАБОТАЕТ
Проверенная граница реализации
Актуальный статус не опубликован. Готовность и условия активации пока не подтверждены.
PRODUCTION BLOCKERS
Что нужно закрыть до активации
Актуальный статус не опубликован. Готовность и условия активации пока не подтверждены.
2. Обмен данными и отдельные возможности
REST API передаёт команды и читает подтверждённое состояние. События уведомляют об изменениях. AssetLink связывает отдельный актив с операционным контуром.
Контракт REST API для всех моделейKafka / WebhooksТранспорт событий, подписи и сверка
Kafka / Webhooks
СТАТУС НЕДОСТУПЕН. Актуальный статус не опубликован. Готовность и условия активации пока не подтверждены.
ПРИМЕР ПОЛЬЗОВАТЕЛЬСКОГО ПУТИ
Как этот вариант выглядит для партнёра и пользователя
- 01
Sandbox-операция атомарно фиксирует state transition и immutable evidence.
- 02
Существующий outbox передаёт локальное событие либо сохраняется signed completion envelope.
- 03
Партнёр дедуплицирует stable event ID и проверяет подпись, когда она есть.
- 04
При пропуске или неоднозначности backend сверяется с authoritative GET status.
Граница обещания: Статус DELIVERED означает in-process проверку signed envelope и не означает HTTPS-доставку или приём события системой партнёра.
Полный статус, среда и условия активации
Фактическая среда
Environment status · Kafka / WebhooksСреда выполнения не подтверждена. Подробности доступны ниже.
Требования среды и технические детали
Выбор показывает требования к среде. Работа приложения, доступ и внешнее исполнение не меняются.
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
- Implementation state
- СТАТУС НЕДОСТУПЕН
- Доступное environment
- NOT PUBLISHEDАктуальный статус не опубликован. Готовность и условия активации пока не подтверждены.
ЧТО РАБОТАЕТ
Проверенная граница реализации
Актуальный статус не опубликован. Готовность и условия активации пока не подтверждены.
PRODUCTION BLOCKERS
Что нужно закрыть до активации
Актуальный статус не опубликован. Готовность и условия активации пока не подтверждены.
AssetLinkОтдельная capability и её ограничения
AssetLink
СТАТУС НЕДОСТУПЕН. Актуальный статус не опубликован. Готовность и условия активации пока не подтверждены.
ПРИМЕР ПОЛЬЗОВАТЕЛЬСКОГО ПУТИ
Как этот вариант выглядит для партнёра и пользователя
- 01
Банк получает существующее eligibility decision для пользователя.
- 02
Trusted BFF создаёт PURCHASE/TRANSFER intent с opaque subject reference.
- 03
Пользователь явно подтверждает или отменяет намерение.
- 04
CertaRail фиксирует ACTION_REQUIRED и evidence без внешнего исполнения.
Граница обещания: CONFIRMED означает сохранённое намерение: деньги и актив не перемещены, provider и blockchain не вызваны.
Полный статус, среда и условия активации
Фактическая среда
Environment status · AssetLinkСреда выполнения не подтверждена. Подробности доступны ниже.
Требования среды и технические детали
Выбор показывает требования к среде. Работа приложения, доступ и внешнее исполнение не меняются.
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 не предполагается.
AssetLink
AssetLink
- Implementation state
- СТАТУС НЕДОСТУПЕН
- Доступное environment
- NOT PUBLISHEDАктуальный статус не опубликован. Готовность и условия активации пока не подтверждены.
ЧТО РАБОТАЕТ
Проверенная граница реализации
Актуальный статус не опубликован. Готовность и условия активации пока не подтверждены.
PRODUCTION BLOCKERS
Что нужно закрыть до активации
Актуальный статус не опубликован. Готовность и условия активации пока не подтверждены.
Сравнить все три модели одновременно
| Вариант | Путь пользователя | Ваша часть | Проверка |
|---|---|---|---|
| Hosted | Отдельная страница CertaRail и возврат в ваш продукт | Создание сессии, данные клиента, проверка результата | Сценарий перехода и подтверждение статуса |
| Embedded | Встроенный интерфейс в вашем продукте | Создание сессии, размещение iframe, обработка событий | Разрешённый origin и подтверждение результата |
| Headless API | Ваш собственный интерфейс | UI, вызовы API, обработка событий и восстановление | Контракты, повторы и сверка состояния |
Сравнение вариантов интеграции CertaRail
Embedded
- Путь пользователя
- Встроенный интерфейс в вашем продукте
- Ваша часть
- Создание сессии, размещение iframe, обработка событий
- Проверка
- Разрешённый origin и подтверждение результата
Headless API
- Путь пользователя
- Ваш собственный интерфейс
- Ваша часть
- UI, вызовы API, обработка событий и восстановление
- Проверка
- Контракты, повторы и сверка состояния
Статус реализации и условия активации
Canonical Capability Status
Актуальный статус не опубликован. Готовность и условия активации пока не подтверждены.
PRODUCTION GATES
Интеграция готова только после отдельного acceptance.
Наличие интерфейса или порта не означает подключённого провайдера. Production требует владельца, договора, credentials, защищённой сети, тестов отказа и evidence.
- 01
Scope и ответственность
Матрица ролей и данных утверждена.
- 02
Credentials и secrets
Выданы через production secret manager.
- 03
Security и compliance review
CORS, TLS, auth, privacy, retention и incident flow проверены.
- 04
Conformance и UAT
Happy path, timeouts, retries и reconciliation пройдены.
- 05
Activation record
Владельцы риска подписали отдельное решение.
СЛЕДУЮЩИЙ ШАГ
Начните с контракта, а не с обещания канала.
Передайте стек, окружения, callback URLs и use case без секретов.
Сделать первый API-запрос