Получайте данные компаний и доступную информацию о владельцах. Выбирайте уровни реестра по странам, затем добавляйте связанный KYC за $0.33 за владельца. AML и другие проверки оплачиваются отдельно.
Нам доверяют более 2000 организаций по всему миру.
Что маркетплейс должен
Объедините данные компаний, заявленных владельцев, связанный KYC и сбор документов в единый рабочий процесс для продавцов. Цены реестра и покрытие данных о владельцах зависят от страны и уровня. Связанный полный KYC стоит $0.33 за человека; AML и сбор документов оплачиваются отдельно.
Выберите нужные проверки: ID, Liveness, Face Match, санкции, адрес, возраст, телефон, email, кастомные вопросы. Перетащите их в рабочий процесс на дашборде или отправьте тот же процесс в наш API. Настраивайте ветвления по условиям, проводите A/B-тесты, код не нужен.
$ curl -X POST https://verification.didit.me/v3/session/ \
-H "x-api-key: $DIDIT_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"workflow_id": "wf_kyb_marketplace",
"vendor_data": "seller-42",
"expected_country": "GB"
}'{ "url": "verify.didit.me/..." }$ curl https://verification.didit.me/v3/session/$SESSION/decision/ \
-H "x-api-key: $DIDIT_API_KEY"
# Decision payload (excerpted):
{ "session_kind": "business", "status": "APPROVED",
"decision": { "company": { "legal_name": "Maker Goods Ltd.", "registry_status": "ACTIVE" },
"key_people": [ ... kyc_session_url per owner ... ]
} }статус APPROVED · IN_REVIEW · DECLINED · AWAITING_USERYou are integrating Didit into a marketplace that lists third-party sellers (Etsy, Shopify, Faire, Amazon Handmade, OnBuy archetype). EU Digital Services Act Article 30 and the new EU Anti-Money Laundering (AML) package require you to verify the seller (KYB) before any listing goes live, and to keep that verification fresh while they sell.
Four obligations on every seller:
1. Pull the company's registry record (legal name, registration number, status, incorporation date) from the authoritative government source.
2. Retrieve available Ultimate Beneficial Owner (UBO) records and collect missing ownership information — anyone owning 25% or more — and run a closed-loop KYC on each one.
3. Screen the company AND every UBO against sanctions, Politically Exposed Persons (PEP), and adverse-media lists.
4. Collect the corporate evidence (certificate of incorporation, tax registration, proof of business address) and watch the seller continuously for status changes, UBO turnover, AML hits, and document expiry.
Pricing (verified live):
- Registry retrieval: country/tier retail pricing, billed at the tier delivered. Company AML, person AML, linked KYC and document collection are separate charges.
- The staging catalog and rollout notes are at https://docs.didit.me/getting-started/kyb-registry-pricing. Search is free; a completed manual-entry step costs USD 0.75 in that release.
- Linked KYC per UBO: $0.33 per UBO (ID + Passive Liveness + Face Match + IP + AML)
- Ongoing AML monitoring: $0.07 per user per year
- First 500 KYC verifications free every month, forever
PRE-REQUISITES
- Production API key from https://business.didit.me (sandbox key in 60s, no card).
- Webhook endpoint with HMAC SHA-256 verification using the X-Signature-V2 header and your webhook secret.
- A workflow_id for KYB from the Workflow Builder. The workflow's type (KYC or KYB) drives the session shape — no explicit business flag is needed on the request.
- A workflow_id for KYC bundled with ID + Passive Liveness + Face Match + IP + AML, used for the linked UBO sessions.
STEP 1 — Create the KYB session
POST https://verification.didit.me/v3/session/
Headers:
x-api-key: <your api key>
Content-Type: application/json
Body:
{
"workflow_id": "<your KYB workflow id>",
"vendor_data": "<your seller id, max 256 chars>",
"callback_url": "https://<your-app>/sellers/kyb/callback",
"expected_country": "GB",
"metadata": {
"seller_id": "<your internal seller id>",
"marketplace_segment": "handmade"
}
}
Response: 201 Created with the hosted session URL. Email it to the seller or embed it in your onboarding UI. Behind the scenes, Didit runs:
- kyb_registry — live registry lookup against the country's authoritative source
- kyb_company_aml — sanctions / PEP / adverse media on the company
- kyb_documents — document collection + Optical Character Recognition (OCR) (incorporation, TIN, proof of address)
- kyb_key_people — UBO + director extraction with linked-KYC sessions
STEP 2 — Read the signed webhook on KYB completion
Didit POSTs to your callback. KYB SESSION statuses are UPPER_SNAKE_CASE:
Body (excerpted):
{
"session_id": "<uuid>",
"session_kind": "business",
"vendor_data": "<your seller id>",
"status": "APPROVED",
"decision": {
"company": {
"legal_name": "Maker Goods Ltd.",
"registration_number": "1029847",
"country_code": "GB",
"registry_status": "ACTIVE"
},
"features": [
{ "node_id": "kyb_registry", "status": "APPROVED" },
{ "node_id": "kyb_company_aml", "status": "APPROVED", "total_hits": 0 },
{ "node_id": "kyb_documents", "status": "APPROVED" },
{ "node_id": "kyb_key_people", "status": "APPROVED",
"key_people": [
{ "uuid": "<uuid>", "name": "Sara Ortega", "role": "director", "is_ubo": true, "ownership_percentage": 60, "kyc_status": "Approved", "kyc_session_url": "https://verify.didit.me/..." },
{ "uuid": "<uuid>", "name": "Niels Janssen", "role": "shareholder", "is_ubo": true, "ownership_percentage": 30, "kyc_status": "Approved", "kyc_session_url": "https://verify.didit.me/..." }
]
}
]
}
}
SESSION status enum (KYB · UPPER_SNAKE_CASE):
NOT_STARTED | IN_PROGRESS | AWAITING_USER | APPROVED | DECLINED | IN_REVIEW | RESUBMITTED | ABANDONED | EXPIRED
FEATURE status enum (inside decision.features[].status · UPPER_SNAKE_CASE):
NOT_FINISHED | APPROVED | DECLINED | IN_REVIEW | RESUB_REQUESTED | AWAITING_USER
Note: kyc_status on key_people IS Title Case ("Approved" / "Declined" / "Pending") — those are KYC sessions linked from inside the KYB feature, not KYB features themselves.
Verify the X-Signature-V2 header BEFORE reading the body — HMAC SHA-256 of the raw bytes with your webhook secret.
STEP 3 — Linked KYC on each UBO is automatic
When the seller completes the hosted KYB flow and submits the UBO list, Didit spawns a child KYC session per UBO using the KYC workflow you configured on the KYB workflow. Each child session has its own session_id and its own hosted URL on the kyc_session_url field inside the key-people block.
You don't need to call POST /v3/session/ again for the UBOs — they're stitched to the parent KYB session automatically. You DO need to drive each UBO through their hosted KYC URL (email it, SMS it, embed it in your seller dashboard).
Per-UBO KYC session status is Title Case With Spaces (KYC convention):
Approved | Declined | In Review | Resubmitted | Expired | Not Finished | Kyc Expired | Abandoned
Linked-KYC pricing: $0.33 per UBO.
STEP 4 — Retrieve the decision
GET https://verification.didit.me/v3/session/{sessionId}/decision/
Headers:
x-api-key: <your api key>
Returns the full KYB decision payload — company block, AML hits, document OCR, every UBO with their kyc_status and kyc_session_url. Use this for audit-pack export and for re-rendering the seller status in your admin UI.
STEP 5 — Decide
Branch logic:
APPROVED → activate the seller, allow listings.
IN_REVIEW → keep listings off, wait for analyst webhook update.
DECLINED → refuse onboarding, log the decision_reason_code.
AWAITING_USER → nudge the seller to complete the pending step (typically UBO list submission).
Pre-DSA Article 30: store the trader information (legal name, registration number, address, contact) in your trader-information record alongside the decision payload.
STEP 6 — Ongoing monitoring is automatic when enabled
Enable Ongoing AML on the seller and on each UBO ($0.07/user/year). AML monitoring handles new screening matches. Registry monitoring is a separate coming-soon service, configured at USD 2/company/year; do not assume it is enabled or included in AML monitoring. Your webhook fires on every state change.
No separate endpoint to call — the same workflow drives it.
WEBHOOK EVENT NAMES
- status.updated — session status changed (filter on data.session_kind === "business" for KYB).
- data.updated — session data changed (registry refresh, key-people submission, document upload, ongoing AML hit).
- business.status.updated — the linked Business entity changed.
- business.data.updated — Business entity data changed.
Verify X-Signature-V2 on every payload. The webhook secret is per-environment — sandbox key is separate from production.
CONSTRAINTS
- KYB session statuses use UPPER_SNAKE_CASE (APPROVED, IN_REVIEW, DECLINED). KYC session statuses use Title Case (Approved, In Review, Declined). They live in different APIs — don't mix them in the same code path.
- Default record retention is 5 years post-relationship per the EU AML package; some jurisdictions go higher.
- You cannot replace the registry lookup with a self-attested form — DSA Article 30 requires the data to come from an authoritative source.
Read the docs:
- https://docs.didit.me/business-verification/integration-guide
- https://docs.didit.me/business-verification/statuses
- https://docs.didit.me/business-verification/webhooks
- https://docs.didit.me/sessions-api/create-session
- https://docs.didit.me/sessions-api/retrieve-session
- https://docs.didit.me/integration/webhooks
Start free at https://business.didit.me — sandbox key in 60 seconds, 500 KYC verifications free every month, no credit card.
Для разработки, тестирования и первых пользователей.
Более 25 модулей с открытыми ценами. Автоматические скидки за объём.
Для больших объёмов и регулируемых программ.
Скидки за объём применяются автоматически по мере роста использования — никаких переговоров, никаких звонков от продаж.
Didit — это инфраструктура для идентификации и борьбы с мошенничеством, платформа, которую мы сами хотели бы иметь, когда создавали продукты: открытая, гибкая и удобная для разработчиков. Она становится полноценной частью вашего стека, а не "черным ящиком", который приходится обходить.
Единый API позволяет проверять физических лиц (KYC, знай своего клиента), юридических лиц (KYB, знай свой бизнес), проверять криптокошельки (KYT, знай свою транзакцию) и отслеживать транзакции в реальном времени. Наша инфраструктура создана, чтобы быть:
В основе платформы: более 14 000 типов документов на 48+ языках, более 1000 источников данных и более 200 сигналов мошенничества для каждой сессии. Инфраструктура Didit динамически обучается с каждой сессией и становится лучше с каждым днем.
Любой маркетплейс, который позволяет третьей стороне предлагать товары или услуги потребителям и принимает за это оплату. Это охватывает:
В Европейском Союзе Закон о цифровых услугах (свод правил ЕС для онлайн-платформ) делает проверку продавцов обязательным требованием с существенными штрафами за несоблюдение. Великобритания, США и большая часть Латинской Америки имеют аналогичные обязательства в соответствии со своими правилами защиты потребителей и борьбы с отмыванием денег.
Полный процесс обычно занимает менее 30 секунд от начала до конца, взять удостоверение личности, сфотографировать документ, сделать селфи, готово. Это самая высокая скорость на рынке. Устаревшие KYC-провайдеры обычно тратят более 90 секунд на тот же процесс.
На бэкенде Didit возвращает результат менее чем за две секунды (p99), от момента завершения селфи пользователем до момента срабатывания вашего вебхука. Мобильный захват оптимизирован для медленных телефонов и сетей: прогрессивное сжатие изображений, отложенная загрузка SDK и передача в одно касание с десктопа на телефон через QR-код, если пользователь начинает на вебе.
Три вещи, в порядке частоты, с которой они "кусают" маркетплейс:
Исторический опыт в этом отношении неумолим. Почти каждый крупный маркетплейс был оштрафован за то, что позволял непроверенным продавцам работать. KYB, это стандартный контроль.
Каждая сессия получает один из семи четких статусов, поэтому ваш код всегда знает, что делать:
Approved, все проверки пройдены. Переведите пользователя дальше.Declined, одна или несколько проверок не пройдены. Вы можете разрешить пользователю повторно отправить конкретный неудавшийся шаг (например, повторно сделать селфи), не запуская весь процесс заново.In Review, помечено для проверки соответствия. Откройте кейс в консоли, просмотрите все сигналы, примите решение об одобрении или отклонении.In Progress, пользователь находится в процессе.Not Started, ссылка отправлена, пользователь еще не открыл ее. Отправьте напоминание, если она долго не открывается.Abandoned, пользователь открыл ссылку, но не завершил вовремя. Возобновите или аннулируйте.Expired, срок действия ссылки на сессию истек. Создайте новую сессию.Подписанный вебхук срабатывает при каждом изменении статуса, поэтому ваша база данных всегда остается синхронизированной. Заброшенные и отклоненные сессии бесплатны.
Производственные данные по умолчанию обрабатываются и хранятся в Европейском Союзе на Amazon Web Services. Для корпоративных клиентов возможен запрос на использование альтернативных регионов, если этого требуют регуляторы соответствующих юрисдикций.
Шифрование повсюду. AES-256 для данных в состоянии покоя во всех базах данных, объектных хранилищах и резервных копиях. Transport Layer Security 1.3 для данных в движении при каждом вызове API, вебхуке и сессии Business Console. Биометрические данные шифруются отдельным ключом Customer Master Key.
Вы сами контролируете срок хранения. По умолчанию срок хранения бессрочный (неограниченный), если вы не настроите более короткий — от 30 дней до 10 лет для каждого приложения. Вы можете удалить любую отдельную сессию в любое время из дашборда или через API.
Сертификаты: SOC 2 Type 1 & Type 2, ISO/IEC 27001:2022, iBeta Level 1 PAD, а также публичное подтверждение от Tesoro / SEPBLAC / CNMV Испании о том, что удаленная верификация личности Didit безопаснее, чем личная верификация. Полный отчет доступен по ссылке /security-compliance.
Didit по умолчанию соответствует требованиям регуляторов, важных для инфраструктуры идентификации:
Подробное описание, все сертификаты, все письма регуляторов: /security-compliance.
Три пути интеграции, выберите тот, который подходит вашему стеку:
Одна и та же панель управления, одна и та же система выставления счетов, одна и та же цена за успешную проверку для всех трех. Пошаговое руководство на docs.didit.me/integration/integration-prompt.
Два набора перечислений, по одному для каждого типа сессии:
Различие в регистре преднамеренное, UPPER_SNAKE для сессии KYB, Title Case для сессии KYC. Они находятся в разных API; не смешивайте их в одной ветке кода.
Для обработчика вебхуков переключайтесь по родительскому статусу KYB. AWAITING_USER, наиболее распространенное промежуточное состояние, обычно это означает, что продавец еще должен предоставить список владельцев или повторно загрузить документ. Состояние автоматически переходит в IN_REVIEW или APPROVED, как только они это сделают.
Проверка при регистрации необходима, но недостаточна, продавцы меняются со временем, владельцы приходят и уходят, а списки санкций обновляются ежедневно. Постоянный мониторинг Didit отслеживает все это:
Все проходит через тот же вебхук status.updated, который вы уже настроили для онбординга. Никаких новых эндпоинтов, никакой дополнительной интеграции.
Стоимость проверки реестра зависит от страны и уровня данных. AML-проверка компании, AML-проверка физических лиц, связанный KYC и сбор документов оплачиваются отдельно. Тарифы и доступность смотрите в таблице цен по странам.
Поиск бесплатен. В текущей промежуточной версии завершенный шаг ручного ввода в реестр стоит $0.75, а получение данных из реестра оплачивается по предоставленному уровню. Перед планированием рабочего процесса в продакшене проверьте доступность релиза и таблицу по странам.
Единый API для KYC, KYB, мониторинга транзакций и проверки кошельков. Интеграция за 5 минут.