Подтверждение владения кошельком - виджет Travel Rule

​

Когда Didit создаёт её для вас

• Перевод находится в статусе UNCONFIRMED_OWNERSHIP - кошелёк контрагента был заявлен как некастодиальный при отправке.
• Перевод исходящий и находится в статусе COUNTERPARTY_VASP_NOT_FOUND - VASP контрагента не удалось определить, поэтому подтверждение владения является единственным оставшимся путём к завершению.

​

Что это подтверждает

​

Контракт проверки подписи сообщения

​

Контракт проверки тестового депозита Satoshi

​

Процесс

​

Создание сессии виджета

curl -X POST https://verification.didit.me/v3/travel-rule/widget-session/ \
  -H "x-api-key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "wallet_address": "0xd3b62acb76fb27a7f8961ec40fa11746b113aca9",
    "chain": "ETH",
    "holder_name": "Jane Doe",
    "vendor_data": "user-042",
    "transaction_id": "99999999-aaaa-bbbb-cccc-dddddddddddd",
    "satoshi_deposit_address": "0x71C7656EC7ab88b098defB751B7401B5f6d8976F",
    "callback_url": "https://yourapp.example/wallet-verified",
    "expires_in_minutes": 60
  }'

{
  "widget_session_id": "77777777-8888-9999-aaaa-bbbbbbbbbbbb",
  "token": "3s9x...urlsafe",
  "url": "https://verify.didit.me/wallet-ownership/3s9x...urlsafe",
  "expires_at": "2026-07-07T13:00:00Z"
}

​

Откройте возвращённый URL

​

Определите завершение

curl https://verification.didit.me/v3/travel-rule/widget/{token}/

{
  "vasp_name": "Origin CASP SL",
  "wallet_address": "0xd3b62acb76fb27a7f8961ec40fa11746b113aca9",
  "chain": "ETH",
  "holder_name": "Jane Doe",
  "allowed_methods": ["MESSAGE_SIGNING", "SCREENSHOT", "SATOSHI_TEST", "SELF_DECLARATION"],
  "transfer_status": "UNCONFIRMED_OWNERSHIP",
  "callback_url": "https://yourapp.example/wallet-verified",
  "expires_at": "2026-07-07T13:00:00Z",
  "completed_at": null,
  "proofs": [
    {
      "proof_id": "88888888-9999-aaaa-bbbb-cccccccccccc",
      "method": "SATOSHI_TEST",
      "status": "PENDING",
      "wallet_address": "0xd3b62acb76fb27a7f8961ec40fa11746b113aca9",
      "chain": "ETH",
      "deposit_address": "0x71C7656EC7ab88b098defB751B7401B5f6d8976F",
      "expected_amount": "0.000042817305521963",
      "expires_at": "2026-07-07T13:05:00.412731+00:00",
      "created_at": "2026-07-06T13:05:00.412731Z"
    }
  ],
  "customization": null
}

• completed_at становится ненулевым, как только подтверждение проверено.
• Каждая запись в proofs содержит поля, нужные её методу: SATOSHI_TEST добавляет deposit_address, expected_amount и собственный expires_at; MESSAGE_SIGNING добавляет challenge, строку, которую подписывает клиент.
• Подтверждение SATOSHI_TEST может оставаться в status: "PENDING", пока депозит виден ончейн, но ещё не подтверждён; от вас и клиента действий не требуется. См. контракт проверки Satoshi test выше.
• Если сессия создана с transaction_id, проверка подтверждения продвигает привязанный перевод, а в продакшн-приложении срабатывает webhook travel_rule.status.updated. Предпочитайте webhook опросу. Для входящего запроса TRP одобрение отправляется обратно отправителю, и запрос переходит в COMPLETED, когда это одобрение доставлено. Любой другой перевод в UNCONFIRMED_OWNERSHIP (или входящий перевод в ON_HOLD) переходит в COMPLETED, либо в COUNTERPARTY_MISMATCHED_DATA, если имя бенефициара не совпадает с владельцем кошелька, а завершившийся урегулированный sunrise-депозит продолжает переход в FINISHED. Исходящий перевод в COUNTERPARTY_VASP_NOT_FOUND переходит в COMPLETED.
• Подтверждение SCREENSHOT в этом контексте остаётся в status: "PENDING", даже после того как вы подтвердили владение. Одобряете его через POST .../travel-rule/ownership/, который принимает только перевод, ожидающий подтверждения владения. Поэтому скриншот невозможно одобрить в сессии без привязанного перевода или в сессии, привязанной к исходящему переводу в COUNTERPARTY_VASP_NOT_FOUND: отключите allow_screenshot_proof, если такие сессии не должны его предлагать.
• После отклонённого подтверждения сессия даёт новую попытку, пока попытки остаются. max_attempts, attempts_used и attempts_remaining показывают счётчик, отклонённое подтверждение содержит rejection_reason, а когда attempts_remaining равно 0, при запуске новой попытки возвращается 409, и тогда нужно создать новую сессию.
• Endpoint контекста возвращает 404 для неизвестного token и 410, если сессия истекла, не завершившись.

​

Локализация и брендинг

​

Следующие шаги