Песочница Travel Rule: руководство по тестированию

​

Перед началом

1. Используйте API-ключ приложения в песочнице. Продакшн-приложения никогда не обращаются к тестовому VASP.
2. Включите Travel Rule с юридическим названием:

curl -X PUT https://verification.didit.me/v3/travel-rule/settings/ \
  -H "x-api-key: YOUR_SANDBOX_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"is_enabled": true, "legal_name": "Example CASP Sandbox"}'

3. По желанию подключите адрес назначения webhook к событию travel_rule.status.updated. Песочница доставляет его с пометкой "environment": "sandbox".

​

Didit Test VASP

​

Сценарии исходящих переводов

curl -X POST https://verification.didit.me/v3/transactions/ \
  -H "x-api-key: YOUR_SANDBOX_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "transaction_id": "sbx-tr-accept-001",
    "transaction_category": "travelRule",
    "transaction_details": {
      "direction": "outbound",
      "action_type": "transfer",
      "amount": "0.25",
      "currency": "ETH",
      "currency_kind": "crypto"
    },
    "subject": { "entity_type": "individual", "vendor_data": "user-042", "full_name": "Jane Doe" },
    "travel_rule_details": {
      "status": "AWAITING_COUNTERPARTY",
      "beneficiary_data": {
        "wallet_address": "0xc00c4cd93ff83953ce3347b33656d68ab8f35cfb",
        "name": "Carlos Ruiz"
      }
    }
  }'

• name_mismatch сравнивает имя получателя, которое вы отправили, с именем держателя, которое возвращает тестовый VASP, по вашему правилу проверки имён для типа субъекта получателя (matching_rules.individual.name или matching_rules.company.name; до тех пор, пока вы их не задали, они следуют за name_matching_strictness). Перевод и запись временной шкалы, которая определила его исход, содержат name_match (с compared_with: "counterparty_vasp") и data_match с mismatched_fields: ["name"].
• not_reachable оставляет перевод в статусе AWAITING_COUNTERPARTY на время повторных попыток, с delivery.status RETRYING и last_error test VASP is not answering, а затем переводит его в COUNTERPARTY_VASP_NOT_REACHABLE. После этого отправьте {"action": "resend"}, чтобы выполнить перевод заново.
• self_hosted заставляет тестовый VASP ответить, что кошелёк является некастодиальным. Зафиксируйте подтверждение с помощью виджета проверки владения кошельком (создаётся для вас, пока включён auto_wallet_verification) или POST .../travel-rule/ownership/ с {"confirmed": true}: кошелёк добавляется в вашу адресную книгу под именем получателя, и решение о переводе принимается по совпадению имён. Совпадение завершает перевод и помечает кошелёк как верифицированный; {"confirmed": false} отклоняет его.

​

Входящие переводы от тестового VASP

curl -X POST https://verification.didit.me/v3/travel-rule/test-vasp/inbound/ \
  -H "x-api-key: YOUR_SANDBOX_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "beneficiary_wallet_address": "0xYourDepositWallet",
    "scenario": "accept",
    "reference": "sbx-inbound-001"
  }'

​

Webhook в песочнице

​

Что песочница не подтверждает

• Что реальный контрагент, членство в сети или публичный TRP-хост Didit работают. Ни один из них не вызывается.
• Что ваши учётные данные сети действительны. Подключённое членство подтверждается его первым боевым обменом.
• Маршруты каталога реальных VASP: в приложении песочницы каждый маршрут показывает unavailable с reason: sandbox_application, а у каждой строки reachable: false.