Receive Travel Rule (PII) data transfers

When you request it or when required by the Originator, you may receive Travel Rule messages. These messages are encrypted based on your DIDDoc settings.

📘

Note: A counterparty will likely send a Travel Rule PII message only after you confirm their request for address ownership. Ensure timely responses and automate this process.

Steps to Receive Travel Rule Messages

1. Subscribe to Webhook Events
   Subscribe to the tap.requirePresentationSatisfied event to get notifications for incoming PII/Travel Rule messages.
2. Retrieve PII Data
   Use the GET Transfer endpoint: {{url}}/entity/:entityDID/tx/:tx?decrypt=false.
   • If encrypted with your keys, you'll receive encrypted data.
   • If encrypted by Notabene, set decrypt=true to request decrypted data.
3. Check Received PII
   • Completed Data: All required fields are present. The status is COMPLETED, and a webhook is sent. Depending on your setup, you may need to authorize or reject.
   • Incomplete Data: Not all fields are present. The status is INCOMPLETE. If updated, the platform re-evaluates and sends a new webhook if complete.

Visual Guide