Перейти к основному содержанию
GET
curl

Авторизации

X-Transaction-Token
string
header
обязательно

Краткосрочный токен с ограниченной областью действия, сгенерированный вашим бэкендом через POST /v3/transactions/sdk-token/. Используется SDK Didit на endpoints /v1/transactions/, предназначенных для взаимодействия с устройством.

Параметры пути

transaction_id
string<uuid>
обязательно

Стабильный UUID транзакции Didit (uuid из ответа на отправку, а не ваш txnId).

Ответ

Полные детали транзакции, включая action_required (null, как только ожидающее действие урегулировано).

Полная запись мониторинга для одной транзакции, возвращаемая GET /v3/transactions/{transaction_id}/ и POST /v3/transactions/.

uuid
string<uuid>

Стабильный идентификатор транзакции Didit. Используйте как {transaction_id} для последующих вызовов.

environment
enum<string>

Среда приложения, которому принадлежит транзакция. Транзакция в sandbox сохраняется, но никогда не оценивается, не проверяется скринингом, по ней не отправляются уведомления и не взимается плата, поэтому пустое значение rule_runs означает «не оценивалась».

Доступные опции:
live,
sandbox
transaction_number
integer

Порядковый номер транзакции в рамках приложения, отображаемый в консоли (например, 4123).

txn_id
string

transaction_id, переданный вами при создании (не более 128 символов). Уникален в рамках приложения.

txn_date
string<date-time>

Когда произошла транзакция (из transaction_at; по умолчанию используется время отправки).

zone_id
string | null

Идентификатор часового пояса IANA, указанный при создании.

transaction_type
string

Категория верхнего уровня в том виде, в котором она сохранена: finance, kyc, travelRule, userPlatformEvent, gamblingBet, gamblingLimitChange, gamblingBonusChange, auditTrailEvent. Обратите внимание, что значения из нескольких слов возвращаются в camelCase, даже если они были переданы в snake_case.

action_type
string

Подтип внутри категории (например, deposit, withdrawal, transfer). Если не указан, по умолчанию совпадает с категорией.

direction
enum<string>

Направление относительно субъекта. Сохраняется в верхнем регистре независимо от переданного регистра (на вход принимаются in/out/inbound/outbound).

Доступные опции:
INBOUND,
OUTBOUND
status
enum<string>

Текущий вердикт мониторинга. Транзакции создаются со статусом APPROVED; правила могут синхронно изменить его на IN_REVIEW/DECLINED.

Доступные опции:
APPROVED,
IN_REVIEW,
DECLINED,
AWAITING_USER
source
enum<string>

Происхождение записи: LIVE для транзакций, переданных через API или SDK, IMPORTED для транзакций, загруженных через импорт в панели управления.

Доступные опции:
LIVE,
IMPORTED
amount
string

Сумма транзакции в виде десятичной строки без завершающих нулей (например, "1500", "0.5", "0.123456789012345678"). До 18 знаков после запятой.

currency
string

Код валюты для amount. Принимается любой буквенный код ISO 4217 (например, EUR, USD, NGN), а также символ криптоактива (например, BTC). Предпочтительно использовать находящийся в обращении код. Не для каждого принятого кода доступен обменный курс: если для кода курс отсутствует (например, расчетная единица ISO XSU или символ криптовалюты, для которого Didit не рассчитывает цену), автоматическая конвертация завершается ошибкой и preferred_currency_amount возвращается со значением null, если только в запросе не был передан предварительно сконвертированный amount_in_default_currency.

currency_type
string | null

fiat или crypto, как передано в currency_kind.

amount_in_default_currency
string | null

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

default_currency_code
string | null
preferred_currency_amount
string | null

Значение amount, конвертированное в предпочтительную валюту приложения, если доступно.

preferred_currency_code
string | null
payment_details
string | null

Назначение платежа или примечание из отправленных данных в виде произвольного текста.

payment_txn_id
string | null

Внешний идентификатор платёжной системы (например, хэш блокчейн-транзакции) из payment_reference_id.

score
integer

Оценка риска, накопленная правилами (обычно 0–100). Выше = рискованнее.

severity
enum<string> | null

Категориальный уровень риска, установленный правилами/провайдерами (UNKNOWN, LOW, MEDIUM, HIGH, CRITICAL). null, пока он не будет задан.

Доступные опции:
UNKNOWN,
LOW,
MEDIUM,
HIGH,
CRITICAL
decision_reason_code
string | null

Машиночитаемая причина текущего status.

decision_reason_label
string | null

Понятная метка для decision_reason_code.

vendor_data
string | null

Удобная копия vendor_data заявителя.

metadata
object

Снимок payload subject и counterparty в том виде, в котором они были отправлены при создании.

props
object

Параметры custom_properties, переданные вами при создании. К каждому ключу можно обращаться в условиях правил как к custom_values.<key>.

tags
object[]

Теги, прикрепленные к транзакции (вручную или правилами).

parties
object[]

Стороны транзакции (заявитель, контрагент).

payment_methods
object[]

Способы оплаты, привязанные к транзакции.

documents
object[]

Файлы, прикреплённые к транзакции из панели управления. [], если файлы отсутствуют.

activities
object[]

Записи журнала действий (создание, заметки, ручные проверки, изменения статуса).

alerts
object[]

В настоящее время всегда пусто. Открытое оповещение представляет собой транзакцию со статусом IN_REVIEW или AWAITING_USER.

rule_runs
object[]

Результаты выполнения по правилам — какое правило сработало и как оно повлияло на скоринг.

provider_results
object[]

Необработанные payload от провайдеров (AML-скрининг, блокчейн-аналитика и т. д.).

travel_rule
object | null

Перевод или проверка Travel Rule. Заполняется, если были переданы travel_rule_details, а также если включён Travel Rule и транзакция была создана с transaction_category: travelRule (Didit инициирует обмен самостоятельно, даже без travel_rule_details). Имеет значение null, если перевод или проверка отсутствуют. При входящем переводе поля контрагента originator_data и beneficiary_data остаются маскированными (data_masked: true) до подтверждения владения кошельком.

network_snapshot
object | null

Снимок графа связанных транзакций/сторон, используемый движком правил. Либо network_snapshot, переданный вместе с транзакцией, либо граф, который Didit строит на основе успешного AML-скрининга кошелька (заменяющий переданный). null, если нет ни того, ни другого.

remediation
object | null

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

action_required
Verification session · object

Ожидающее выполнения действие конечного пользователя, необходимое для завершения этой транзакции, или null, если действий нет. Didit SDK автоматически запускают действие по умолчанию и обновляют транзакцию по его завершении. Два варианта, различаемые по полю type: verification_session (размещённая сессия верификации, созданная действием правила) и wallet_ownership (сессия виджета подтверждения владения кошельком, автоматически созданная для перевода Travel Rule, требующего подтверждения контроля над кошельком; управляется настройкой Travel Rule auto_wallet_verification). Если применимы оба варианта, приоритет имеет wallet_ownership, поскольку оно блокирует обмен данными Travel Rule.

cost_breakdown
object | null

Стоимость этой транзакции: total_price и items, по одному на каждое списание, каждый с полями usage_type, price, details и created_at. Повторный скрининг той же транзакции формирует новую позицию.

Последнее изменение 7 ноября 2026 г.