Получение настроек Travel Rule через API: профиль VASP

curl

curl -X GET https://verification.didit.me/v3/travel-rule/settings/ \
  -H 'x-api-key: YOUR_API_KEY'

using System;
using System.Text.Json;
using Didit;

// Reads DIDIT_API_KEY.
using var client = new DiditClient();

var result = await client.TravelRule.RetrieveSettingsAsync();
Console.WriteLine(JsonSerializer.Serialize(result));

{
  "is_enabled": false,
  "jurisdiction": "EU",
  "name_matching_strictness": "DEFAULT",
  "confirmation_timeout_hours": 48,
  "timeout_outcome": "HOLD",
  "threshold_amount": "0.00",
  "inbound_auto_accept": true,
  "allow_self_declaration": true,
  "allow_screenshot_proof": true,
  "auto_wallet_verification": true,
  "vasp_attribution_enabled": true,
  "legal_name": "",
  "lei": "",
  "compliance_email": "",
  "is_discoverable": true,
  "counterparty_screening_enabled": false,
  "sunrise_policy": "",
  "sunrise_jurisdictions": [
    "CO",
    "KH",
    "VN"
  ],
  "non_responsive_policy": "",
  "travel_address": "",
  "disabled_networks": [],
  "networks": {
    "gtr": {
      "rail": "GTR",
      "mode": "unavailable",
      "state": "didit_onboarding",
      "reason": "didit_membership_not_live",
      "platform_available": false,
      "connected": false,
      "participant": null,
      "vasps_reachable": 0,
      "routed_30d": 0
    },
    "trust": {
      "rail": "TRUST",
      "mode": "unavailable",
      "state": "unavailable",
      "reason": "own_membership_only",
      "platform_available": false,
      "connected": false,
      "participant": null,
      "vasps_reachable": 0,
      "routed_30d": 0
    },
    "verifyvasp": {
      "rail": "VERIFYVASP",
      "mode": "unavailable",
      "state": "didit_onboarding",
      "reason": "didit_membership_not_live",
      "platform_available": false,
      "connected": false,
      "participant": null,
      "vasps_reachable": 0,
      "routed_30d": 0
    },
    "sygna": {
      "rail": "SYGNA",
      "mode": "unavailable",
      "state": "didit_onboarding",
      "reason": "didit_membership_not_live",
      "platform_available": false,
      "connected": false,
      "participant": null,
      "vasps_reachable": 0,
      "routed_30d": 0
    }
  },
  "didit_network": {
    "listed": false,
    "missing": [
      "travel_rule_off",
      "legal_name_missing",
      "compliance_email_missing"
    ],
    "compliance_email_confirmed": false
  }
}

GET

travel-rule

settings

curl

curl -X GET https://verification.didit.me/v3/travel-rule/settings/ \
  -H 'x-api-key: YOUR_API_KEY'

using System;
using System.Text.Json;
using Didit;

// Reads DIDIT_API_KEY.
using var client = new DiditClient();

var result = await client.TravelRule.RetrieveSettingsAsync();
Console.WriteLine(JsonSerializer.Serialize(result));

{
  "is_enabled": false,
  "jurisdiction": "EU",
  "name_matching_strictness": "DEFAULT",
  "confirmation_timeout_hours": 48,
  "timeout_outcome": "HOLD",
  "threshold_amount": "0.00",
  "inbound_auto_accept": true,
  "allow_self_declaration": true,
  "allow_screenshot_proof": true,
  "auto_wallet_verification": true,
  "vasp_attribution_enabled": true,
  "legal_name": "",
  "lei": "",
  "compliance_email": "",
  "is_discoverable": true,
  "counterparty_screening_enabled": false,
  "sunrise_policy": "",
  "sunrise_jurisdictions": [
    "CO",
    "KH",
    "VN"
  ],
  "non_responsive_policy": "",
  "travel_address": "",
  "disabled_networks": [],
  "networks": {
    "gtr": {
      "rail": "GTR",
      "mode": "unavailable",
      "state": "didit_onboarding",
      "reason": "didit_membership_not_live",
      "platform_available": false,
      "connected": false,
      "participant": null,
      "vasps_reachable": 0,
      "routed_30d": 0
    },
    "trust": {
      "rail": "TRUST",
      "mode": "unavailable",
      "state": "unavailable",
      "reason": "own_membership_only",
      "platform_available": false,
      "connected": false,
      "participant": null,
      "vasps_reachable": 0,
      "routed_30d": 0
    },
    "verifyvasp": {
      "rail": "VERIFYVASP",
      "mode": "unavailable",
      "state": "didit_onboarding",
      "reason": "didit_membership_not_live",
      "platform_available": false,
      "connected": false,
      "participant": null,
      "vasps_reachable": 0,
      "routed_30d": 0
    },
    "sygna": {
      "rail": "SYGNA",
      "mode": "unavailable",
      "state": "didit_onboarding",
      "reason": "didit_membership_not_live",
      "platform_available": false,
      "connected": false,
      "participant": null,
      "vasps_reachable": 0,
      "routed_30d": 0
    }
  },
  "didit_network": {
    "listed": false,
    "missing": [
      "travel_rule_off",
      "legal_name_missing",
      "compliance_email_missing"
    ],
    "compliance_email_confirmed": false
  }
}

Доступность сетей

Для GTR, TRUST, VerifyVASP и Sygna требуется действующее членство. Сегодня у Didit нет платформенного членства ни в одной из этих сетей: Didit подключается к ним как провайдер. До этого момента канал сети маршрутизируется только через ваше собственное членство, подключённое в Marketplace. Прочитайте networks для приложения, которое вы настраиваете:

own - Ваше подключённое членство имеет приоритет, даже если сеть указана в disabled_networks. Биржи используют вашу идентичность в сети.
didit - Членство Didit представляет ваше приложение как собственного активного участника этой сети, с кодом, который выдала сеть. Учётные данные членства клиента для этой сети не нужны. Чтобы получить этот режим, нужны анкета Didit для сети и запрос в сеть: см. Получить сети Travel Rule. Продакшн пока не сообщает об этом режиме, потому что собственное членство Didit ещё не активно.
off - Вы отключили платформенную маршрутизацию и не подключили собственное членство. Удалите сеть из disabled_networks, чтобы разрешить платформенную маршрутизацию, когда она станет доступна, или подключите собственное членство.
unavailable - Отправка через эту сеть для вашего приложения пока невозможна. state и reason объясняют причину, например didit_onboarding, пока собственное членство Didit в сети не активно, или questionnaire_needed, пока ваша анкета не одобрена. Сегодня каждая сеть сообщает этот режим, если вы не подключили собственное членство и не отключили сеть. Подключите собственное членство в Marketplace или используйте контрагента, доступного через INTERNAL, TRP или EMAIL.

disabled_networks влияет только на платформенное членство Didit, которое пока недоступно, поэтому сегодня оно не влияет на маршрутизацию. Канал сети выбирается, когда beneficiary_data перевода содержит идентификатор контрагента в этой сети (например, counterparty_gtr_vasp_code или counterparty_trust_membership_id), или когда запись контрагента в справочнике указывает эту сеть под каким-либо кодом. Для GTR, VerifyVASP и Sygna Didit получает ответ контрагента из ответа сети или опрашивая сеть каждые 5 минут, и перевод переходит в COMPLETED, COUNTERPARTY_MISMATCHED_DATA или COUNTERPARTY_VASP_GENERAL_DECLINE. TRUST поддерживает только отправку: перевод, отправленный через TRUST, остаётся в AWAITING_COUNTERPARTY, пока не истечёт confirmation_timeout_hours и он не станет EXPIRED; после этого применяется timeout_outcome. Если сообщение нельзя доставить, перевод переходит в COUNTERPARTY_VASP_NOT_REACHABLE. Что каждая сеть охватывает сегодня, см. в разделе Сети Travel Rule. platform_available означает статус конфигурации, а не проверку состояния сети в реальном времени. connected означает, что сохранённое членство прошло локальную проверку учётных данных, но не то, что обмен с провайдером прошёл успешно. Включение is_enabled или очистка disabled_networks не могут подключить отсутствующее членство. Проверки, которые можно выполнить без учётных данных сети, см. в разделе Тестирование без учётных данных сети.

Авторизации

x-api-key

string

header

обязательно

API-ключ вашего приложения из раздела «Разработчикам» -> «API-ключи» в Business Console. Основной ключ имеет полный доступ. Именованный ключ может иметь ограниченную область действия: без доступа, чтение или запись для каждого ресурса, ограничение определенными сценариями или одобренными сессиями, списком IP-адресов и сроком действия. 401 означает, что ключ неверен, отозван или его срок действия истек; 403 означает, что ключ не был передан, у ключа нет доступа к этому ресурсу или действию, либо запрос поступил с адреса вне его списка IP-адресов; 404 на маршруте сессии означает, что сессия не входит в сценарии или статусы ключа. Ключ без доступа к медиа получает URL изображений, видео и PDF как null, а ключ без прав на запись сессий получает ссылки на сессии и токены как null. См. https://docs.didit.me/console/api-keys.

Ответ

200 - application/json

Текущие настройки Travel Rule и профиль VASP.

is_enabled

boolean

Активен ли управляемый сценарий согласования Travel Rule для исходящих транзакций travelRule в этом приложении.

jurisdiction

string

Код юрисдикции деятельности вашего VASP. По умолчанию "EU". Didit сопоставляет его с режимом, который указывается в ваших транзакциях Travel Rule как travel_rule_regime (например, EU или код страны-участницы ЕС преобразуется в eu), на основе которого могут срабатывать правила транзакций. Другие клиенты Didit видят его как вашу юрисдикцию в каталоге VASP после того, как сеть Didit опубликует ваш профиль.

Maximum string length: 8

name_matching_strictness

enum<string>

Насколько строго должны совпадать имена получателей, чтобы перевод мог перейти в статус COMPLETED. CONTAINS принимает имя, все слова которого содержатся в другом имени.

Доступные опции:

NONE,

STRICT,

CONTAINS,

DEFAULT,

FUZZY

confirmation_timeout_hours

integer

Количество часов, в течение которых перевод со статусом AWAITING_COUNTERPARTY может оставаться неподтверждённым, прежде чем периодический процесс очистки переведёт его в статус истекшего. По умолчанию 48.

Требуемый диапазон: x >= 1

timeout_outcome

enum<string>

Что происходит с базовой транзакцией, когда срок действия перевода истекает. По умолчанию HOLD. sunrise_policy и non_responsive_policy имеют приоритет, если они применимы и заданы.

Доступные опции:

HOLD,

REJECT,

PROCEED

threshold_amount

string

Десятичная строка в валюте по умолчанию вашего приложения. Минимальная сумма перевода, запускающая управляемый обмен; переводы ниже этой суммы сразу получают статус NOT_APPLICABLE. Didit сравнивает сумму транзакции, конвертированную в вашу валюту по умолчанию, или переданное вами значение amount_in_default_currency; если конвертированная сумма недоступна, порог не применяется. По умолчанию "0.00" (EU TFR не устанавливает минимальную сумму).

ownership_validation_mode

enum<string>

Требуемый объём подтверждения владения кошельком. FULL всегда требует подтверждения (подписанное сообщение, тестовый депозит или проверенный скриншот), но никогда не слов конечного пользователя. SIMPLIFIED принимает самостоятельное декларирование ниже simplified_validation_threshold и подтверждение выше него. AUTOMATED позволяет адресной книге и более ранним подтверждениям отвечать автоматически, включая самостоятельные декларации при значении allow_self_declaration, равном true. По умолчанию AUTOMATED.

Доступные опции:

FULL,

SIMPLIFIED,

AUTOMATED

simplified_validation_threshold

string

Десятичная строка, по умолчанию "0.00". В режиме SIMPLIFIED для перевода ниже этой суммы (в валюте порога) принимается самостоятельное заявление. Перевод без указания суммы в этой валюте считается превышающим её.

Поля, которые Didit отправляет VASP контрагента о ваших пользователях, для каждого типа сущности. Поля name и wallet_address отправляются всегда, независимо от содержимого списка. Для типа сущности, который вы не настроили, передаются все поля. Пустой список тоже является выбором: в этом случае передаются только имя и кошелёк.

Show child attributes

matching_rules

object

Насколько строго сравнивается каждое поле данных контрагента с имеющимися у вас данными в зависимости от типа субъекта. Поле, которое вы пропускаете, сохраняет значение по умолчанию. NONE пропускает сравнение, STRICT требует абсолютно одинаковых слов, CONTAINS допускает значение, все слова которого присутствуют в другом, DEFAULT выполняет стандартное сопоставление подмножеств, а FUZZY допускает близкое написание (а для дат рождения допускает перестановку дня и месяца).

Show child attributes

legal_name

string

Юридическое наименование вашего VASP. Обязательно (не пустое) для установки is_enabled в true.

lei

string

Ваш идентификатор юридического лица, отображаемый в каталоге VASP.

compliance_email

string<email>

Контактный адрес электронной почты комплаенс-службы для вашего VASP-профиля. Сеть Didit отобразит ваш профиль только после подтверждения этого адреса по ссылке из электронного письма (POST /v3/travel-rule/settings/compliance-email/confirmation/); при его изменении потребуется повторное подтверждение.

is_discoverable

boolean

Может ли ваш профиль VASP отображаться в сети Didit: доступен для поиска через GET /v3/travel-rule/vasps/ другими клиентами Didit и достижим по каналу INTERNAL. Для включения в список также требуется приложение в продакшн-среде, включённый Travel Rule, юридическое наименование и подтверждённый email комплаенс-отдела; didit_network указывает, какие из них отсутствуют. По умолчанию true.

inbound_auto_accept

boolean

Если true, входящий запрос TRP, в котором кошелек получателя является подтвержденной записью адресной книги с совпадающим именем, одобряется автоматически. Если false, такой запрос остается в статусе ON_HOLD до тех пор, пока вы не одобрите или не отклоните его с помощью endpoint проверки владения. Не влияет на переводы по каналу INTERNAL и переводы после депозита. По умолчанию true.

allow_self_declaration

boolean

Если true, виджет подтверждения владения кошельком предлагает самостоятельное декларирование в качестве резервного метода подтверждения. По умолчанию true.

allow_screenshot_proof

boolean

Если true, виджет подтверждения владения кошельком предлагает загрузку скриншота в качестве метода подтверждения владения. По умолчанию true.

auto_wallet_verification

boolean

Если true, отправка исходящего перевода по Travel Rule, требующего подтверждения контроля над кошельком конечным пользователем, автоматически создает привязанную к транзакции сессию виджета подтверждения владения кошельком и отображает ее в блоке action_required транзакции. По умолчанию true.

vasp_attribution_enabled

boolean

Если true, исходящий перевод по Travel Rule, который не может маршрутизировать ни один канал, атрибутируется с помощью блокчейн-аналитики: для кошелька назначения определяется владеющий им VASP, организация фиксируется в переводе и в каталоге VASP, а каналы запускаются повторно один раз с именем, определенным при атрибуции. По умолчанию true.

counterparty_screening_enabled

boolean

Подключаемый скрининг контрагентов VASP на санкции и негативные публикации в СМИ, тарифицируемый за каждый скрининг по цене AML-скрининга компаний. При включении Didit выполняет скрининг контрагента, к которому обращается исходящий обмен (повторно используя скрининг давностью менее 30 дней), и вы можете проверить контрагента с помощью POST /v3/travel-rule/vasps/{vasp_id}/screening/. По умолчанию false: скрининг и списание средств не производятся.

sunrise_policy

enum<string>

Действие с транзакцией при истечении срока перевода, когда контрагент является записью каталога в юрисдикции из sunrise_jurisdictions, которая ещё не применяет Travel Rule: HOLD переводит её на проверку, REJECT отклоняет её, PROCEED оставляет статус без изменений. Пустое значение (по умолчанию) следует timeout_outcome. Применяется перед non_responsive_policy.

Доступные опции:

HOLD,

REJECT,

PROCEED

sunrise_jurisdictions

string[]

read-only

Только для чтения. Страны (ISO 3166 alpha-2), которые Didit относит к переходному периоду Travel Rule, где применяется sunrise_policy. В настоящее время это CO, KH и VN. Любая другая юрисдикция, а также пустая или неизвестная, использует timeout_outcome.

non_responsive_policy

enum<string>

Действие с транзакцией при истечении срока перевода, когда контрагент является записью каталога со статусом отклика UNRESPONSIVE: HOLD, REJECT или PROCEED, аналогично timeout_outcome. Пустое значение (по умолчанию) следует timeout_outcome. Если подходят оба правила, сначала применяется sunrise_policy.

Доступные опции:

HOLD,

REJECT,

PROCEED

travel_address

string

Только для чтения. Собственный Travel Address вашего VASP - закодированный endpoint входящих запросов TRP, который другие VASP используют для связи с вами. Пусто, пока is_enabled имеет значение false.

disabled_networks

enum<string>[]

Сети, отказавшиеся от участия в платформе. Не отключает ваши собственные подключённые членства и не предоставляет недоступные сети.

Доступные опции:

GTR,

TRUST,

VERIFYVASP,

SYGNA

networks

object

read-only

По каждой сети: как это приложение будет отправлять данные и почему оно не может этого сделать. Ни одна сеть, включая GTR, не подключена по умолчанию: сеть доступна через ваше собственное подключённое членство или через членство Didit, когда членство Didit в этой сети активировано и ваш собственный участник в ней активен. Не является проверкой состояния или доставки в реальном времени.

Show child attributes

didit_network

object

read-only

Включён ли ваш профиль VASP в сеть Didit, чтобы другие клиенты Didit могли найти его в каталоге и связаться с ним по каналу INTERNAL, а также каждое условие, которое всё ещё не выполнено.

Show child attributes

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

​Доступность сетей

Авторизации

Ответ

Доступность сетей