Для разработчикаДалее: Заявка на интеграцию

OPENAPI 3.1 · ASYNCAPI 3.1 · LOCAL

Фактические контракты — с границами исполнения в самом описании.

CertaRail предоставляет control-plane API для decisions, evidence, policy, limits, review cases, sandbox trading и corporate treasury. Ни один endpoint не отправляет live order, payment, withdrawal или blockchain transfer.

Запросить sandbox Посмотреть демо

Другие способы начать

Подготовить запрос на пилот Сделать первый API-запрос

RESTКанонический OpenAPI 3.1

СобытияКанонический AsyncAPI 3.1

Внешние вызовы по умолчанию0

Внешний monetary / asset эффектNOT_EXECUTED

START HERE

Минимальный путь локальной проверки.

01
Запустите PostgreSQL и API
Compose-конфигурация поднимает локальную авторитетную запись.
02
Используйте sandbox bearer
Tenant определяется сервером; конфликтующий tenant отклоняется.
03
Передайте idempotency key
Повтор того же payload возвращает committed response; другой payload даёт 409.
04
Читайте decision и receipt
Business outcome и audit evidence коммитятся атомарно.
05
Не трактуйте sandbox как execution
External calls равны нулю; данные синтетические.

Sandbox eligibility request

curl -X POST http://localhost:8080/v1/eligibility/evaluations \
  -H "Authorization: Bearer <sandbox-bearer>" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: bank-order-000001" \
  -d '{
    "request_id": "bank-order-000001",
    "tenant_id": "sandbox-bank",
    "facts_observed_at": "2026-08-24T18:20:00Z",
    "operation": "BUY",
    "asset_code": "DEMO-BTC",
    "amount": { "currency": "RUB", "minor_units": 25000000 },
    "client": {
      "subject_ref": "cust_7fd2",
      "facts_version": "kyc-443",
      "residency": "RU",
      "investor_category": "RETAIL",
      "kyc_status": "VERIFIED",
      "screening_status": "CLEAR",
      "knowledge_test": {
        "passed": true,
        "passed_at": "2026-08-01T00:00:00Z",
        "valid_until": "2027-08-01T00:00:00Z"
      },
      "risk_disclosure": {
        "accepted": true,
        "version": "sandbox-risk-v1",
        "accepted_at": "2026-08-24T18:15:00Z"
      },
      "annual_volume": { "currency": "RUB", "minor_units": 10000000 }
    },
    "intermediary": { "kind": "BROKER", "regulated": true }
  }'

MACHINE SOURCES

Контракты поставляются без отдельной маркетинговой схемы.

GUIDES

Developer Portal

Quickstart, API, events, webhooks и integration rules

ARCHITECTURE

Границы системы

Control plane, владельцы, evidence flow и external effects

REST

certrail.openapi.v1.yaml

OpenAPI 3.1 · синхронизирован с Go API

EVENTS

certrail.asyncapi.v1.yaml

AsyncAPI 3.1 · local Kafka · at-least-once

PROTOCOL BEHAVIOR

Интеграционные правила определены до подключения провайдера.

Поведение API CertaRail
Область	Фактическое поведение	Production gap
Аутентификация	Tenant-bound sandbox bearer	Production IdP, rotation, service identities
Идемпотентность	Stable replay; payload conflict → 409	Shared durable policy across external commands
Ошибки	Strict JSON; 400/401/403/409/415/429/503	Partner-specific observability and support routing
Rate limits	In-flight backpressure; Retry-After where documented	Edge quotas and contractual limits
Events	Transactional outbox, at-least-once, event_id dedupe	TLS/SASL/ACL and external delivery
Webhooks	Signed checkout envelope, tenant-scoped Inbox, subscription rotation, test events, bounded/manual retry	External production HTTPS delivery, production secrets, UAT
SDK	TypeScript, Python и Go SDK 0.1.0 source packages; local package/module gates	Public npm/PyPI/Go module distribution, provenance attestation, owner approval

Поведение API CertaRail

Аутентификация

Фактическое поведение: Tenant-bound sandbox bearer
Production gap: Production IdP, rotation, service identities

Идемпотентность

Фактическое поведение: Stable replay; payload conflict → 409
Production gap: Shared durable policy across external commands

Ошибки

Фактическое поведение: Strict JSON; 400/401/403/409/415/429/503
Production gap: Partner-specific observability and support routing

Rate limits

Фактическое поведение: In-flight backpressure; Retry-After where documented
Production gap: Edge quotas and contractual limits

Events

Фактическое поведение: Transactional outbox, at-least-once, event_id dedupe
Production gap: TLS/SASL/ACL and external delivery

Webhooks

Фактическое поведение: Signed checkout envelope, tenant-scoped Inbox, subscription rotation, test events, bounded/manual retry
Production gap: External production HTTPS delivery, production secrets, UAT

SDK

Фактическое поведение: TypeScript, Python и Go SDK 0.1.0 source packages; local package/module gates
Production gap: Public npm/PyPI/Go module distribution, provenance attestation, owner approval

Opaque references

Передавайте subject references, а не персональные данные, если контракт не требует иного.

Retry same command

После timeout повторяйте тот же idempotency key и payload, а не создавайте новый intent.

Evidence ≠ execution

Decision, order draft или provider observation не доказывают движение денег или актива.

СЛЕДУЮЩИЙ ШАГ

Выполните первый запрос в безопасном sandbox-контуре.

Developer Console использует synthetic fixtures: запрос создаёт проверяемую запись, но не вызывает внешнего провайдера.

Сделать первый API-запрос