> ## Documentation Index > Fetch the complete documentation index at: https://docs.didit.me/llms.txt > Use this file to discover all available pages before exploring further. # API списка транзакций: KYT-мониторинг > Получите отслеживаемые транзакции Didit: оценки риска, серьёзность, контрагенты, теги и статус скрининга. Оплата за вызов KYT, без контрактов. Промпт для API получения списка транзакций Скопировать промпт в буфер обмена \

\`List monitored transactions for my Didit application through the Management API.

Endpoint:
GET https://verification.didit.me/v3/transactions/

Authentication:
Use the x-api-key header with my Didit API key.

Goal:
\- Retrieve a paginated list of high-level transaction summaries (score, severity, status, parties, tags, decision metadata) — suitable for back-office review screens, fraud dashboards, and audit exports.

Query parameters:
\- limit - page size (default 50, min 1).
\- offset — zero-based offset (default 0). Prefer following the next URL from the previous page.

Ordering & pagination:
\- Ordered by txn_date descending (most recent first), with created_at as a tie-breaker.
\- count is a bounded counter (exact up to 100, capped above). Use total_transactions when present for the true count.
\- Transactions deleted via the Console are not returned.

Filtering:
\- Besides limit / offset, this endpoint accepts travel_rule_status, an exact Travel Rule status (for example ON_HOLD), and then returns only transactions whose Travel Rule transfer is in that status.
count follows this filter, but total_transactions always counts every transaction in the application.
\- It also accepts assignee, a comma-separated list where any value matches: me (the calling reviewer, with a user token), unassigned, rules (decided by the rules alone, no reviewer involved), or a member email.
\- For other filtering (party, status, severity, date range), use the Console UI.

Example call:
curl -X GET "https://verification.didit.me/v3/transactions/?limit=50" \
-H "x-api-key: YOUR_API_KEY"

What to read from each row:
\- uuid — stable Didit transaction id; use as {transaction_id} in GET /v3/transactions/{transaction_id}/.
\- transaction_number — application-scoped sequential number shown in Console.
\- txn_id — the identifier you supplied at create time (max 128 chars, unique per application).
\- status, score, severity, decision_reason_code, decision_reason_label — live monitoring verdict.
\- direction, amount, currency — raw submission. amount is a decimal string.
\- subject_name / subject_vendor_data / subject_country — denormalized APPLICANT party fields.
\- counterparty_name / counterparty_vendor_data / counterparty_country — denormalized COUNTERPARTY fields (may be null).
\- tags — Console tags (uuid, name, color).
\- assigned_to_name — Console reviewer who owns the transaction.
\- travel_rule_status - the status of the transaction's Travel Rule transfer (for example COMPLETED), or null when it has none.
\- travel_rule - the same Travel Rule block as GET /v3/transactions/{transaction_id}/ (status, direction, rail, counterparty_vasp, delivery, discovery, reason, next_actions and the rest), or null when the transaction has none.
Read reason and next_actions to see why each COUNTERPARTY_VASP_NOT_FOUND or COUNTERPARTY_VASP_NOT_REACHABLE transfer is stuck without one read per transaction.

Failure modes:
\- 403 - missing x-api-key (a wrong, revoked or expired key gets 401), or a key without permission for this action; the body is a { "detail": "..." } envelope.
\- 429 — rate limited; back off and retry.

Side effects: none. This is a pure read.

For the full integration shape, see /integration/integration-prompt.`

\
Вставьте в ## OpenAPI ````yaml ru/openapi-25.json GET /v3/transactions/ openapi: 3.0.0 info: version: 3.0.0 title: Didit Verification API description: >- API верификации личности. Аутентификация выполняется с помощью заголовка x-api-key. servers: - url: https://verification.didit.me security: [] tags: [] paths: /v3/transactions/: get: tags: - Transactions summary: Получить список транзакций description: >- Список отслеживаемых транзакций с пагинацией, сначала новые (`txn_date` desc). Значение `count` ограничено 100; используйте `total_transactions` для получения точного количества строк. Этот endpoint не поддерживает параметры фильтрации или поиска. operationId: listTransactions parameters: - name: limit in: query schema: type: integer default: 50 minimum: 1 maximum: 1000000 description: >- Размер страницы. По умолчанию 50, если не указан. Жёсткого максимума нет, но рекомендуется оставлять страницы небольшими для уменьшения задержки. - name: offset in: query schema: type: integer maximum: 1000000 minimum: 0 default: 0 description: >- Смещение первой возвращаемой записи, начиная с нуля. Рекомендуется переходить по URL `next` с предыдущей страницы. - name: travel_rule_status in: query required: false schema: type: string description: >- Возвращает только те транзакции, перевод Travel Rule которых находится именно в этом статусе (например, `ON_HOLD` или `AWAITING_COUNTERPARTY`). Значение `count` учитывает этот фильтр; `total_transactions` по-прежнему считает все транзакции в приложении. - name: assignee in: query required: false schema: type: string description: >- Разделены запятыми; транзакция соответствует при совпадении с любым значением. `unassigned` означает то, что ещё ни за кем не закреплено, `rules` означает то, по чему правила вынесли решение самостоятельно без проверяющего, а email участника сопоставляется с назначенным проверяющим. `me` означает вошедшего в Console проверяющего, поэтому API-ключ, отправляющий `me`, возвращает `400`. responses: '200': description: Список сводок по транзакциям с пагинацией, сначала новые. content: application/json: schema: type: object properties: count: type: integer description: >- Ограниченное количество подходящих транзакций (точное значение до 100, далее ограничено). Используйте `total_transactions` для получения точного количества при пагинации. next: type: string nullable: true description: >- Абсолютный URL следующей страницы или `null` на последней странице. previous: type: string nullable: true description: >- Абсолютный URL предыдущей страницы или `null` на первой странице. total_transactions: type: integer description: >- Точное общее количество (неудалённых) транзакций приложения. Присутствует в постраничных ответах. results: type: array items: type: object properties: uuid: type: string format: uuid description: >- Постоянный идентификатор транзакции Didit. Используйте как `{transaction_id}` в вызовах для получения деталей, заметок и связанных данных. transaction_number: type: integer description: >- Порядковый номер транзакции в рамках приложения, отображаемый в консоли (например, `4123`). txn_id: type: string description: >- Идентификатор, предоставленный клиентом при вызове создания (максимум 128 символов). Уникален в рамках приложения. transaction_type: type: string description: >- Категория верхнего уровня в том виде, в котором она сохранена: `finance`, `kyc`, `travelRule`, `userPlatformEvent`, `gamblingBet`, `gamblingLimitChange`, `gamblingBonusChange`, `auditTrailEvent`. Обратите внимание, что значения из нескольких слов возвращаются в camelCase, даже если они были переданы в snake_case. action_type: type: string description: >- Подтип внутри категории (например, `deposit`, `withdrawal`, `transfer`). status: type: string enum: - APPROVED - IN_REVIEW - DECLINED - AWAITING_USER description: Текущий вердикт мониторинга. direction: type: string enum: - INBOUND - OUTBOUND description: >- Направление относительно субъекта. Сохраняется в верхнем регистре независимо от переданного регистра. amount: type: string description: >- Сумма транзакции в виде десятичной строки без завершающих нулей (например, `"1500"`, `"0.5"`, `"0.123456789012345678"`). До 18 знаков после запятой. currency: type: string description: >- Код валюты для `amount`. Принимается любой буквенный код ISO 4217 (например, `EUR`, `USD`, `NGN`), а также символ криптоактива (например, `BTC`). Предпочтительно использовать находящийся в обращении код. Не для каждого принятого кода доступен обменный курс: если для кода курс отсутствует (например, расчетная единица ISO `XSU` или символ криптовалюты, для которого Didit не рассчитывает цену), автоматическая конвертация завершается ошибкой и `preferred_currency_amount` возвращается со значением null, если только в запросе не был передан предварительно сконвертированный `amount_in_default_currency`. preferred_currency_amount: type: string nullable: true description: >- Значение `amount`, конвертированное в предпочтительную валюту приложения, если доступно. preferred_currency_code: type: string nullable: true description: >- Предпочтительный код валюты, используемый для `preferred_currency_amount` - базовая валюта приложения, любой код ISO 4217, находящийся в обращении в настоящее время. При отсутствии доступного обменного курса для кода `preferred_currency_amount` остаётся null, если только в запросе не была передана предварительно сконвертированная `amount_in_default_currency`. payment_details: type: string nullable: true description: >- Назначение платежа или примечание из отправленных данных в виде произвольного текста. score: type: integer description: Оценка риска (обычно 0–100). Выше = рискованнее. severity: type: string nullable: true enum: - UNKNOWN - LOW - MEDIUM - HIGH - CRITICAL description: >- Категориальный уровень риска, установленный правилами/провайдерами (`UNKNOWN`, `LOW`, `MEDIUM`, `HIGH`, `CRITICAL`). `null`, пока он не будет задан. subject_name: type: string nullable: true description: Полное имя стороны `APPLICANT`. subject_vendor_data: type: string nullable: true description: >- Ваш внутренний идентификатор пользователя/бизнеса для заявителя. subject_country: type: string nullable: true description: >- Код страны заявителя из переданного `address.country` (обычно ISO 3166-1 alpha-3). counterparty_name: type: string nullable: true description: Полное имя стороны `COUNTERPARTY`, если применимо. counterparty_vendor_data: type: string nullable: true description: Ваш внутренний идентификатор контрагента. counterparty_country: type: string nullable: true description: >- Код страны контрагента из переданного `address.country`. tags: type: array items: type: object properties: uuid: type: string format: uuid name: type: string color: type: string description: type: string nullable: true source: type: string enum: - didit - custom description: >- Является ли тег предустановленным тегом Didit или пользовательским. description: >- Теги, прикрепленные к транзакции (вручную или правилами). txn_date: type: string format: date-time description: >- Когда произошла транзакция (из `transaction_at` при создании). created_at: type: string format: date-time description: Когда Didit зафиксировал отправку. decision_reason_code: type: string nullable: true description: >- Машиночитаемая причина текущего `status` (например, `WALLET_HIGH_RISK`). decision_reason_label: type: string nullable: true description: Понятная метка для `decision_reason_code`. assigned_to_name: type: string nullable: true description: >- Отображаемое имя проверяющего в Console, назначенного на эту транзакцию. travel_rule_status: type: string nullable: true description: >- Статус передачи Travel Rule для транзакции (например, `COMPLETED`), или `null`, если её нет. travel_rule: nullable: true allOf: - $ref: '#/components/schemas/TransactionTravelRule' description: >- Перевод Travel Rule транзакции, тот же блок, что и `travel_rule` в `GET /v3/transactions/{transaction_id}/`, или `null`, если у транзакции его нет. examples: Single transaction: value: count: 1 next: null previous: null total_transactions: 1 results: - uuid: abcdef12-3456-4890-abcd-ef1234567890 transaction_number: 4123 txn_id: your-txn-2026-05-17-001 transaction_type: finance action_type: withdrawal status: IN_REVIEW direction: OUTBOUND amount: '1500' currency: EUR preferred_currency_amount: '1620.45' preferred_currency_code: USD payment_details: Withdrawal to crypto wallet txn_date: '2026-05-17T08:42:00Z' created_at: '2026-05-17T08:42:11Z' score: 78 severity: HIGH decision_reason_code: WALLET_HIGH_RISK decision_reason_label: Destination wallet flagged as high risk tags: - uuid: 9a8b7c6d-5e4f-4a3b-8c2d-1e0f9a8b7c6d name: Manual review color: '#F59E0B' description: null source: custom subject_name: Maria Garcia subject_vendor_data: user-12345 counterparty_name: null counterparty_vendor_data: null counterparty_country: null subject_country: null assigned_to_name: Alex Reviewer travel_rule_status: null travel_rule: null '403': description: >- Отсутствующий, недействительный или отозванный API-ключ, либо у ключа нет прав на получение списка транзакций для этого приложения. При отсутствии ключа возвращается `403`; при неверном, отозванном или истекшем ключе возвращается `401`. content: application/json: examples: Forbidden: value: detail: You do not have permission to perform this action. '429': description: >- Лимит запросов превышен; снизьте частоту запросов и повторите попытку через интервал, указанный в `Retry-After`. content: application/json: examples: Throttled: value: detail: Request was throttled. Expected available in 30 seconds. security: - ApiKeyAuth: [] x-codeSamples: - lang: curl label: curl source: >- curl -X GET 'https://verification.didit.me/v3/transactions/?limit=50' \ -H 'x-api-key: YOUR_API_KEY' - lang: python label: Python source: |- from didit import Didit # Reads DIDIT_API_KEY. client = Didit() for item in client.transactions.list(): print(item) - lang: javascript label: Node.js source: |- import Didit from "@didit-protocol/sdk-node"; // Reads DIDIT_API_KEY. const didit = new Didit(); for await (const item of didit.transactions.list()) { console.log(item); } - lang: go label: Go source: "ctx := context.Background()\n// Reads DIDIT_API_KEY.\nclient := didit.NewClient()\n\niter := client.Transactions.ListAutoPaging(ctx, didit.TransactionsListParams{})\nfor iter.Next() {\n\tfmt.Printf(\"%+v\\n\", iter.Current())\n}\nif err := iter.Err(); err != nil {\n\tlog.Fatal(err)\n}" - lang: java label: Java source: |- import me.didit.Didit; // Reads DIDIT_API_KEY. Didit client = new Didit(); for (var item : client.transactions().list()) { System.out.println(item); } - lang: php label: PHP source: |- transactions->list() as $item) { print_r($item->toArray()); } - lang: ruby label: Ruby source: |- require "didit" # Reads DIDIT_API_KEY. didit = Didit::Client.new didit.transactions.list.auto_paging_each do |item| puts item.to_h end - lang: csharp label: .NET source: |- using System; using System.Text.Json; using Didit; // Reads DIDIT_API_KEY. using var client = new DiditClient(); await foreach (var item in await client.Transactions.ListAsync()) { Console.WriteLine(JsonSerializer.Serialize(item)); } components: schemas: TransactionTravelRule: type: object description: >- Перевод Travel Rule для транзакции в том виде, в котором его возвращают `GET /v3/transactions/{transaction_id}/`, ответ `201` метода `POST /v3/transactions/` и каждая строка `GET /v3/transactions/`. Поля `direction`, `rail`, `counterparty_vasp`, `delivery`, `discovery`, `reason` и `next_actions` имеют ту же структуру, что и в `PATCH /v3/transactions/{transaction_id}/travel-rule/`, поэтому одно чтение транзакции объясняет, почему перевод заблокирован и что необходимо сделать для его продвижения. properties: uuid: type: string format: uuid status: type: string protocol: type: string nullable: true required: type: boolean obligations_count: type: integer originator_data: type: object description: >- Сторона-отправитель. Для входящего перевода значения контрагента маскируются до тех пор, пока владение не будет подтверждено. beneficiary_data: type: object description: >- Сторона-получатель. Для входящего перевода значения контрагента маскируются до подтверждения владения. name_match: type: object nullable: true description: >- Сравнение имен, на основе которого было принято решение по переводу (оценка и строгость). Null до выполнения проверки. Сравниваемые имена маскируются вместе со сторонами. data_match: $ref: '#/components/schemas/TravelRuleDataMatch' mismatched_fields: type: array items: type: string description: >- Сокращение для `data_match.mismatched_fields`. Пусто, если различий нет. data_unmasked: $ref: '#/components/schemas/TravelRuleDataUnmasked' data_masked: type: boolean description: >- Имеет значение true, пока персональные данные контрагента маскируются в этом ответе. metadata: type: object direction: type: string enum: - INBOUND - OUTBOUND description: Какой стороной обмена является данный перевод. rail: type: string nullable: true description: >- Транспортная сеть (rail), через которую прошёл перевод: `INTERNAL`, `TRP`, `GTR`, `TRUST`, `VERIFYVASP`, `SYGNA` или `EMAIL` (`TEST_VASP` в приложении в песочнице, когда ответил Didit Test VASP), либо `null` до выбора сети. counterparty_vasp: type: object nullable: true properties: name: type: string lei: type: string dd_score: type: integer description: >- Оценка дью-дилидженс от 0 до 100, где большее значение лучше. Та же шкала, что и в каталоге VASP. dd_score_breakdown: type: object description: >- Вклад каждого компонента в dd_score: один объект на компонент в соответствии со справочником VASP (jurisdiction, verification, protocol, lei, history, essentials, responsiveness), каждый со структурой {points, max, reason, detail}. Пустой объект {}, пока контрагент не был оценён. additionalProperties: type: object properties: points: type: number description: Баллы, начисленные за этот компонент. max: type: integer description: >- Максимальное количество баллов, которое может начислить этот компонент. reason: type: string description: Машиночитаемый код вердикта компонента. detail: type: string description: Понятная человеку причина начисления баллов. dd_assessed_at: type: string format: date-time nullable: true description: >- Когда в последний раз проводилась оценка в рамках комплексной проверки. Null, пока контрагент не был оценён. description: >- Запись контрагента в каталоге или `null`, если перевод не привязан ни к одной. delivery: nullable: true allOf: - $ref: '#/components/schemas/TravelRuleDelivery' description: >- Последнее сообщение, которое перевод должен отправить другой стороне. `null`, если отправка не требовалась, например ниже `threshold_amount` или для заявленного некастодиального кошелька. discovery: type: array description: >- Как Didit выполнял поиск контрагента: по одной записи на каждый выполненный шаг. Пусто, если поиск не выполнялся, например для входящего перевода. items: $ref: '#/components/schemas/TravelRuleDiscoveryStep' reason: type: string description: >- Причина, по которой перевод со статусом `COUNTERPARTY_VASP_NOT_FOUND` или `COUNTERPARTY_VASP_NOT_REACHABLE` приостановлен; `""` для любого другого статуса. Неудачная доставка определяет её в первую очередь и только при `COUNTERPARTY_VASP_NOT_REACHABLE`: `email_undeliverable` (почтовый провайдер отклонил комплаенс-письмо, и адресов для повторной попытки не осталось: при отправке, при напоминании или в виде постоянного сбоя доставки, о котором сообщено позже) или `delivery_failed` (канал доставки окончательно вышел из строя: сетевой канал отклонил сообщение или исчерпал лимит повторных попыток, хост идентификации `TRP` не ответил либо `TRP`-хост контрагента не принял запрос). В противном случае её определяет трассировка `discovery`: `awaiting_end_user` (ни на одном шаге не указан контрагент, с которым Didit может связаться), `directory_match_no_route` (на шаге указан VASP из каталога, у которого нет маршрута), `picked_member_without_proven_wallet` (конечный пользователь выбрал клиента Didit, который не подтвердил контроль над кошельком) или `no_directory_match`, если трассировка не возвращает иной причины. Повторная отправка продвигает перевод дальше, поэтому причина сбрасывается. См. [Почему перевод приостановлен](/ru/transaction-monitoring/travel-rule#почему-перевод-застрял). next_actions: type: array description: >- Действия, продвигающие перевод дальше; `[]` для любого статуса, кроме `COUNTERPARTY_VASP_NOT_FOUND` или `COUNTERPARTY_VASP_NOT_REACHABLE`. `email_undeliverable` предлагает `update_compliance_email`, затем `resend`. `delivery_failed` предлагает `resend`. Причина типа discovery предлагает `select_counterparty_vasp`, `declare_self_hosted`, `add_vasp_hint` и `resend`. items: $ref: '#/components/schemas/TravelRuleNextAction' chain_details: $ref: '#/components/schemas/TravelRuleChainDetails' TravelRuleDataMatch: type: object nullable: true description: >- Сравнение по каждому полю данных стороны перевода с тем, что известно другой стороне о владельце кошелька. Указывает поля и результаты, но никогда значения, сохраняя читаемость при маскировании данных контрагента. Имеет значение null до запуска сравнения. properties: matched: type: boolean description: True, когда ни одно из сравниваемых полей не отличается. mismatched_fields: type: array items: type: string enum: - name - date_of_birth - address - account description: Поля, которые различаются. fields: type: object description: >- Одна запись на каждое сравниваемое поле для типа стороны (`name`, `date_of_birth`, `address`, `account`; у компании нет поля `date_of_birth`). additionalProperties: type: object properties: result: type: string enum: - matched - mismatched - not_compared description: >- `not_compared`, если правило имеет значение `NONE` или на одной из сторон отсутствует значение для поля. strictness: type: string enum: - NONE - STRICT - CONTAINS - DEFAULT - FUZZY TravelRuleDataUnmasked: type: object nullable: true description: >- Запись аудита момента, когда данные контрагента были демаскированы. Имеет значение null, пока данные всё ещё замаскированы, а также для исходящих переводов. properties: at: type: string format: date-time reason: type: string enum: - ownership_confirmed - wallet_proof - address_book_match - own_verified_wallet - inquiry_approved - known_payment_method - travel_address description: >- Что подтвердило владение: ownership_confirmed (ваше подтверждение через консоль или API), wallet_proof (подтверждение кошелька в виджете или входящий перевод INTERNAL, устанавливается при его создании), address_book_match (верифицированный кошелёк из адресной книги), own_verified_wallet (собственный верифицированный кошелёк вашего пользователя), inquiry_approved (ваше одобрение входящего TRP-запроса или сообщения GTR либо Sygna), known_payment_method (кошелёк, с которого ваш пользователь уже совершал оплату) или travel_address (Travel Address конкретного кошелька, обозначающий этот кошелёк). actor: type: string description: >- Кто подтвердил решение: email пользователя консоли или метка API-ключа. Пусто для автоматического решения. TravelRuleDelivery: type: object description: >- Текущий статус последнего сообщения, которое перевод должен отправить другой стороне. Didit связывается с контрагентом после возврата ответа на запрос, создавший или изменивший перевод, поэтому данный объект показывает, было ли доставлено это сообщение: в очереди, отправляется, ожидает повторной попытки после ошибки, доставлено или произошел сбой. В случае сбоя, после которого сеть еще может восстановиться (нет ответа вовремя, ошибка соединения, HTTP `408`, `429` или `5xx`), повторная попытка выполняется через 30 секунд, 2 минуты, 10 минут, 30 минут и 1 час. Если первое сообщение (`kind: SEND`) окончательно завершается сбоем из-за отказа сети или неудачи шестой попытки, перевод переходит в статус `COUNTERPARTY_VASP_NOT_REACHABLE` с полем `last_error` в истории `timeline`; любое другое сообщение, окончательно завершившееся ошибкой, фиксируется в `timeline`. Поле `status` перевода остается первоисточником истины для самого обмена. required: - kind - status - rail - attempts - last_error - next_attempt_at - delivered_at properties: kind: type: string enum: - SEND - ANSWER - TXID - CANCEL - POLL description: >- Что содержит сообщение. `SEND`: первое сообщение перевода контрагенту (исходящее; канал передачи выбирается при отправке). `ANSWER`: ваше согласие или отклонение, направляемое запросившей сети (входящее). `TXID`: хеш ончейн-транзакции после завершения перевода. `CANCEL`: отмена после того, как вы отменили перевод. `POLL`: запрос статуса к сети, поддерживающей такую возможность, повторяемый каждые 5 минут, пока перевод ожидает ответа от контрагента. status: type: string enum: - QUEUED - SENDING - RETRYING - DELIVERED - FAILED description: >- `QUEUED`: ожидает отправки. `SENDING`: выполняется попытка. `RETRYING`: попытка завершилась неудачей, следующая запустится в `next_attempt_at`. `DELIVERED`: принимающая сторона приняла сообщение. `FAILED`: принимающая сторона отклонила его или последняя попытка завершилась неудачей. rail: type: string enum: - INTERNAL - TRP - GTR - TRUST - VERIFYVASP - SYGNA - EMAIL - '' description: >- Транспортная сеть (rail), передающая сообщение. Пусто до тех пор, пока Didit не выберет её для первого сообщения. attempts: type: integer minimum: 0 description: >- Количество попыток, сделанных для этого сообщения на данный момент. Для сообщения, не являющегося опросом статуса, выполняется не более 6 попыток. last_error: type: string description: >- Тип сбоя, возникшего при последней попытке, либо `""`, если сбоев не было: например `email undeliverable`, `trp identity endpoint unreachable` или `trp transfer inquiry delivery failed`. Он никогда не содержит собственный ответ контрагента, который сохраняется в `timeline` перевода. Когда GTR возвращает ошибку, включаются собственный код состояния и сообщение. Тела ответов никогда не включаются. example: email undeliverable next_attempt_at: type: string format: date-time nullable: true description: >- Время следующей попытки, пока сообщение находится в статусе `QUEUED` или `RETRYING`. delivered_at: type: string format: date-time nullable: true description: Время получения сообщения другой стороной. TravelRuleDiscoveryStep: type: object description: >- Один шаг поиска контрагента, выполненный Didit для исходящего перевода, в порядке их выполнения. Первый шаг, определяющий VASP с доступным маршрутом, завершает цепочку. properties: step: type: string enum: - internal_address_book - wallet_attribution - network_lookup - customer_hint - end_user description: >- `internal_address_book`: другой клиент Didit, подтвердивший контроль над кошельком назначения. `wallet_attribution`: атрибуция блокчейн-аналитики кошелька. `network_lookup`: сеть, способная определить, какой VASP управляет адресом. `customer_hint`: имя VASP, LEI или юрисдикция, переданные вами в `beneficiary_data`. `end_user`: контрагент, выбранный конечным пользователем (или вами), либо запрос на его выбор. outcome: type: string enum: - match - miss - skipped description: >- `match`: шаг определил контрагента. `miss`: шаг был выполнен, но совпадений не найдено. `skipped`: шаг не удалось выполнить, причина указана в `reason`. reason: type: string description: >- Машиночитаемая причина, `""` при совпадении: `no_proven_internal_wallet`, `attribution_disabled`, `already_attributed`, `no_attributed_entity`, `directory_match_no_route`, `gtr_address_lookup_runs_on_dispatch`, `no_membership`, `network_switched_off`, `no_network_address_lookup`, `no_directory_match`, `awaiting_end_user` или `picked_member_without_proven_wallet`. vasp: type: string format: uuid nullable: true description: VASP из каталога, указанный на данном шаге, если он был указан. rail: type: string nullable: true description: >- Транспортная сеть (rail), через которую достигается этот контрагент, если шаг её обнаружил. at: type: string format: date-time TravelRuleNextAction: type: object description: >- Одно действие, которое позволяет продвинуть перевод со статусом `COUNTERPARTY_VASP_NOT_FOUND` или `COUNTERPARTY_VASP_NOT_REACHABLE`. См. раздел [Почему перевод завис](/ru/transaction-monitoring/travel-rule#почему-перевод-застрял). properties: action: type: string enum: - select_counterparty_vasp - declare_self_hosted - add_vasp_hint - update_compliance_email - resend description: >- `select_counterparty_vasp`: конечный пользователь выбирает VASP назначения в виджете владения кошельком, либо вы отправляете PATCH с `action=beneficiary_vasp`. `declare_self_hosted`: конечный пользователь объявляет кошелёк некастодиальным в виджете. `add_vasp_hint`: укажите Didit, кто является контрагентом, с помощью названия VASP, LEI или Travel Address (например, `travel_address` в записи адресной книги кошелька назначения), затем повторите отправку. `update_compliance_email` и `resend` являются значениями `action` для `PATCH /v3/transactions/{transaction_id}/travel-rule/`: передайте адрес электронной почты комплаенс-службы контрагента повторно и перезапустите маршрутизацию. url: type: string format: uri description: >- Ссылка на виджет подтверждения владения кошельком, при `select_counterparty_vasp` и `declare_self_hosted`, пока у перевода есть открытая сессия виджета. required: - action TravelRuleChainDetails: type: object description: >- Как блокчейн перевода именует два своих кошелька, когда перевод выполняется не просто с одного адреса на другой. Пусто (`{}`) для переводов в сетях на основе аккаунтов (EVM, Solana, Tron), где эти два адреса и есть кошельки. Сопоставление, маршрутизация и адресная книга читают кошельки в первую очередь отсюда. properties: chain: type: string description: >- Каноническая сеть, например `BTC`, `XRP` или `LIGHTNING` для перевода через Lightning. shape: type: string enum: - utxo - memo - lightning originator: $ref: '#/components/schemas/TravelRuleChainSide' beneficiary: $ref: '#/components/schemas/TravelRuleChainSide' utxo: type: object description: >- Для перевода UTXO: входы и выходы в сохраненном виде (суммы в виде десятичных строк) и то, как именно Didit интерпретировал выходы. properties: inputs: type: array items: $ref: '#/components/schemas/TravelRuleUtxoEntry' outputs: type: array items: $ref: '#/components/schemas/TravelRuleUtxoEntry' change_output_indexes: type: array items: type: integer description: Выходы, возвращающие средства обратно на адрес входа. beneficiary_output_index: type: integer nullable: true description: >- Выход, выплачивающий средства получателю; null, если не удалось определить ни один. lightning: type: object description: >- Для перевода Lightning: содержимое платежного запроса. Всегда `kind` (`bolt11`, `bolt12_offer`, `bolt12_invoice`, `bolt12_invoice_request`, `lnurl`, `lightning_address`, `node_id` или `unknown`); инвойс BOLT11 добавляет `network`, `payee_node_id`, `payment_hash`, `amount_msat`, `created_at` и `expires_at`; строка BOLT12 добавляет `blinded_paths` и `payee_node_id`; LNURL или Lightning Address добавляет свой `domain`. По сети ничего не запрашивается: выполняется только декодирование запроса. additionalProperties: true warnings: type: array items: type: string enum: - declared_originator_not_an_input - declared_beneficiary_not_an_output - beneficiary_output_ambiguous - beneficiary_output_amount_differs description: >- Несоответствия UTXO, заслуживающие внимания: заявленный отправитель отсутствует во входах (inputs), заявленный получатель отсутствует в выходах (outputs), невозможно выделить единственный выход получателя или сумма в выходе получателя отличается от указанной в транзакции. not_applicable_reason: type: string enum: - LIGHTNING_NO_PAYEE_IDENTIFIER - LIGHTNING_BOLT12_BLINDED_PAYEE - LIGHTNING_LNURL_NAMES_NO_PAYEE description: >- Для исходящего перевода Lightning, в платежном запросе которого не указан получатель: причина, почему перевод имеет статус `NOT_APPLICABLE`. `LIGHTNING_NO_PAYEE_IDENTIFIER` (в запросе не указан узел получателя или запрос не удалось декодировать), `LIGHTNING_BOLT12_BLINDED_PAYEE` (предложение скрывает своего получателя за слепыми путями), `LIGHTNING_LNURL_NAMES_NO_PAYEE` (LNURL указывает сервис, а не получателя). Тот же код открывает последнюю запись `timeline` перевода. TravelRuleChainSide: type: object description: Кошелёк одной из сторон, определённый Didit на основе данных блокчейна. properties: address: type: string description: >- Кошелёк. В сетях с memo это классический адрес (XRP X-address разделяется на классический адрес и тег); в Lightning это идентификатор узла получателя или Lightning Address. memo: type: string description: >- Destination tag или memo, являющиеся частью кошелька; `""`, если отсутствует. source: type: string enum: - declared - x_address - largest_input - only_non_change_output - amount_match - invoice_payee - updated description: >- Откуда получен кошелёк: `declared` (ваш запрос), `x_address` (выделен из X-адреса XRP), `largest_input` (входной адрес UTXO с наибольшим вкладом), `only_non_change_output` (единственный выход UTXO, не являющийся сдачей), `amount_match` (единственный выход UTXO, выплачивающий сумму перевода), `invoice_payee` (получатель, указанный в платежном запросе Lightning), `updated` (установлен позже с помощью `action: update_originator_wallet`). TravelRuleUtxoEntry: type: object description: >- Один вход или выход UTXO-транзакции в том виде, в каком он зафиксирован в блокчейне. required: - address properties: address: type: string maxLength: 128 amount: type: string nullable: true description: >- Десятичная строка в единицах самой монеты (BTC, не сатоши). Необязательно. example: '0.0125' txid: type: string maxLength: 128 description: Необязательно. Транзакция, которую расходует вход (input). vout: type: integer nullable: true minimum: 0 description: >- Необязательно. Индекс выхода (output index), который расходуется входом (input). securitySchemes: ApiKeyAuth: type: apiKey in: header name: x-api-key description: >- API-ключ вашего приложения из раздела «Разработчикам» -> «API-ключи» в Business Console. Основной ключ имеет полный доступ. Именованный ключ может иметь ограниченную область действия: без доступа, чтение или запись для каждого ресурса, ограничение определенными сценариями или одобренными сессиями, списком IP-адресов и сроком действия. 401 означает, что ключ неверен, отозван или его срок действия истек; 403 означает, что ключ не был передан, у ключа нет доступа к этому ресурсу или действию, либо запрос поступил с адреса вне его списка IP-адресов; 404 на маршруте сессии означает, что сессия не входит в сценарии или статусы ключа. Ключ без доступа к медиа получает URL изображений, видео и PDF как null, а ключ без прав на запись сессий получает ссылки на сессии и токены как null. См. https://docs.didit.me/console/api-keys. ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.