{"templateId":"markdown","versions":[{"version":"v1.41","label":"v1.41 STS","link":"/products/custody/compliance/travel-rule/incoming","default":true,"active":true,"folderId":"c15a2701"},{"version":"v1.40","label":"v1.40 STS","link":"/products/custody/v1.40/compliance/travel-rule/incoming","default":false,"active":false,"folderId":"c15a2701"},{"version":"v1.34","label":"v1.34 LTS","link":"/products/custody/v1.34/compliance/travel-rule/incoming","default":false,"active":false,"folderId":"c15a2701"},{"version":"v1.26","label":"v1.26 LTS","link":"/products/custody/v1.26/compliance/travel-rule/incoming","default":false,"active":false,"folderId":"c15a2701"},{"version":"v1.19","label":"v1.19 LTS","link":"/products/custody/v1.19/compliance/travel-rule/incoming","default":false,"active":false,"folderId":"c15a2701"},{"version":"v1.15","label":"v1.15 LTS","link":"/products/custody/v1.15/compliance/travel-rule/incoming","default":false,"active":false,"folderId":"c15a2701"}],"sharedDataIds":{"sidebar":"sidebar-products/custody/@v1.15/sidebars.yaml"},"props":{"metadata":{"markdoc":{"tagList":["admonition"]},"type":"markdown"},"seo":{"title":"Receive assets with Travel Rule","description":"User guides, API reference, and support resources.","siteUrl":"https://docs.ripple.com","lang":"en-US","llmstxt":{"hide":false,"sections":[{"title":"Table of contents","includeFiles":["**/*"],"excludeFiles":[]}],"excludeFiles":[]}},"dynamicMarkdocComponents":[],"compilationErrors":[],"ast":{"$$mdtype":"Tag","name":"article","attributes":{},"children":[{"$$mdtype":"Tag","name":"Heading","attributes":{"level":1,"id":"receive-assets-with-travel-rule","__idx":0},"children":["Receive assets with Travel Rule"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["This workflow covers detecting and processing incoming deposits with Travel Rule compliance. ","Ripple Custody"," automatically handles most of this process."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["For an incoming transfer, the originator's VASP sends the Travel Rule message, including any PII, to your VASP in Notabene. ","Ripple Custody"," looks up that message by transaction hash and polls only its ",{"$$mdtype":"Tag","name":"em","attributes":{},"children":["status"]}," to decide whether to release the quarantined funds."]},{"$$mdtype":"Tag","name":"Admonition","attributes":{"type":"info","name":"PII stays in Notabene"},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Ripple Custody"," never receives the PII payload from Notabene for incoming transfers. Originator and beneficiary PII remains in your Notabene account, where your compliance team can review it."]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"prerequisites","__idx":1},"children":["Prerequisites"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/products/custody/compliance/travel-rule/setup"},"children":["Travel Rule setup"]}," complete"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Wallet addresses registered with Notabene (","Ripple Custody"," does this automatically when you connect your Notabene account and when you create new wallets)"]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"process-flow","__idx":2},"children":["Process flow"]},{"$$mdtype":"Tag","name":"Diagram","attributes":{"data-language":"mermaid","diagramType":"mermaid","diagramSource":"sequenceDiagram\n participant Blockchain\n participant Custody\n participant Notabene\n\n Blockchain->>Custody: 1. Incoming transfer detected\n Custody->>Custody: Funds quarantined\n\n Custody->>Custody: 2. Screen risk (if configured)\n alt Screening failed\n Custody->>Custody: AUTO_REJECTED (no Travel Rule check)\n else Screening passed or not configured\n Custody->>Notabene: 3. Look up Travel Rule message by transaction hash\n alt Message found\n Notabene-->>Custody: Return message status (no PII)\n Custody->>Notabene: Poll until status is final\n else No matching message\n Custody->>Custody: Insufficient counterparty data (manual review)\n end\n end\n\n Custody->>Custody: 4. Compliance decision\n\n alt AUTO_APPROVED\n Custody->>Custody: 5. Release funds\n Custody->>Notabene: Notify settlement\n else AUTO_REJECTED or NEED_EXPLICIT_DECISION\n Custody->>Custody: Funds remain quarantined\n end\n","diagramHtml":"","diagramHtmlDark":""},"children":["sequenceDiagram\n participant Blockchain\n participant Custody\n participant Notabene\n\n Blockchain->>Custody: 1. Incoming transfer detected\n Custody->>Custody: Funds quarantined\n\n Custody->>Custody: 2. Screen risk (if configured)\n alt Screening failed\n Custody->>Custody: AUTO_REJECTED (no Travel Rule check)\n else Screening passed or not configured\n Custody->>Notabene: 3. Look up Travel Rule message by transaction hash\n alt Message found\n Notabene-->>Custody: Return message status (no PII)\n Custody->>Notabene: Poll until status is final\n else No matching message\n Custody->>Custody: Insufficient counterparty data (manual review)\n end\n end\n\n Custody->>Custody: 4. Compliance decision\n\n alt AUTO_APPROVED\n Custody->>Custody: 5. Release funds\n Custody->>Notabene: Notify settlement\n else AUTO_REJECTED or NEED_EXPLICIT_DECISION\n Custody->>Custody: Funds remain quarantined\n end\n"]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"step-1-transaction-detection-and-quarantine","__idx":3},"children":["Step 1: Transaction detection and quarantine"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["When an incoming transaction is detected on the blockchain, ","Ripple Custody"," automatically:"]},{"$$mdtype":"Tag","name":"ol","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Detects the incoming transfer."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Quarantines the funds pending compliance checks."]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["No action required"]}," — this is automatic."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"step-2-risk-screening","__idx":4},"children":["Step 2: Risk screening"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["If transaction screening is configured (Chainalysis or Elliptic), ","Ripple Custody"," screens the transaction first."]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["If screening fails"]}," (high risk score): The transaction is immediately rejected. No Travel Rule check occurs."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["If screening passes"]},": The workflow proceeds to the Travel Rule check."]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"step-3-travel-rule-check","__idx":5},"children":["Step 3: Travel Rule check"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Ripple Custody"," searches your ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"https://notabene.id"},"children":["Notabene"]}," account for an incoming Travel Rule message that matches the transaction hash:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["If a matching message exists"]},": ","Ripple Custody"," polls Notabene for the message status until it reaches a final state (for example, ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["AUTHORIZED"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["SETTLED"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["REJECTED"]},", or ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["FLAGGED"]},"). It retrieves only the status. The PII payload stays in Notabene."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["If no matching message exists"]},": There isn't enough counterparty data to complete the check. The transfer enters ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["NEED_EXPLICIT_DECISION"]}," and requires manual review (see ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"#handle-no-data-scenarios"},"children":["Handle \"no data\" scenarios"]},")."]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["If the message doesn't reach a final status within the polling window (approximately 5 minutes by default), ","Ripple Custody"," also routes the transfer to manual review."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"step-4-compliance-decision","__idx":6},"children":["Step 4: Compliance decision"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Ripple Custody"," evaluates the results:"]},{"$$mdtype":"Tag","name":"div","attributes":{"className":"md-table-wrapper"},"children":[{"$$mdtype":"Tag","name":"table","attributes":{"className":"md"},"children":[{"$$mdtype":"Tag","name":"thead","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Screening Result"},"children":["Screening Result"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Travel Rule Result"},"children":["Travel Rule Result"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Decision"},"children":["Decision"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Approved"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Approved"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["AUTO_APPROVED"]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Rejected"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["—"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["AUTO_REJECTED"]}," (Travel Rule skipped)"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Approved"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Rejected"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["AUTO_REJECTED"]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Inconclusive"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Inconclusive"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["NEED_EXPLICIT_DECISION"]}]}]}]}]}]},{"$$mdtype":"Tag","name":"Admonition","attributes":{"type":"info"},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["If only one check is configured (screening only or Travel Rule only), the decision is based on that single check."]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"step-5-fund-release-or-rejection","__idx":7},"children":["Step 5: Fund release or rejection"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["If ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["AUTO_APPROVED"]},":"]}]},{"$$mdtype":"Tag","name":"ol","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Funds are released from quarantine."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["After on-chain settlement, Notabene is notified."]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["If ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["AUTO_REJECTED"]},":"]}]},{"$$mdtype":"Tag","name":"ol","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Funds remain quarantined."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Notabene is notified of rejection."]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["If ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["NEED_EXPLICIT_DECISION"]},":"]}," ","Funds remain quarantined. Manual review is required in ","Ripple Custody"," (see below)."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"handle-no-data-scenarios","__idx":8},"children":["Handle \"no data\" scenarios"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["When an incoming transfer arrives but the originating VASP has not provided Travel Rule data, the transfer may enter ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["NEED_EXPLICIT_DECISION"]}," status, requiring manual handling."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"manual-approval-or-rejection","__idx":9},"children":["Manual approval or rejection"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["After manual review in ","Ripple Custody",", the compliance team can approve or reject the transfer:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Approved"]},": Funds are released and Notabene is notified after on-chain settlement."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Rejected"]},": Funds remain quarantined and Notabene is notified of rejection."]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"next-steps","__idx":10},"children":["Next steps"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/products/custody/compliance/travel-rule/outgoing-no-pii"},"children":["Send without PII"]}," — Outgoing transfers when PII is not required."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/products/custody/compliance/travel-rule/outgoing-with-pii"},"children":["Send with PII"]}," — Outgoing transfers when PII is required."]}]}]},"headings":[{"value":"Receive assets with Travel Rule","id":"receive-assets-with-travel-rule","depth":1},{"value":"Prerequisites","id":"prerequisites","depth":2},{"value":"Process flow","id":"process-flow","depth":2},{"value":"Step 1: Transaction detection and quarantine","id":"step-1-transaction-detection-and-quarantine","depth":2},{"value":"Step 2: Risk screening","id":"step-2-risk-screening","depth":2},{"value":"Step 3: Travel Rule check","id":"step-3-travel-rule-check","depth":2},{"value":"Step 4: Compliance decision","id":"step-4-compliance-decision","depth":2},{"value":"Step 5: Fund release or rejection","id":"step-5-fund-release-or-rejection","depth":2},{"value":"Handle \"no data\" scenarios","id":"handle-no-data-scenarios","depth":2},{"value":"Manual approval or rejection","id":"manual-approval-or-rejection","depth":3},{"value":"Next steps","id":"next-steps","depth":2}],"frontmatter":{"seo":{"title":"Receive assets with Travel Rule"}},"lastModified":"2026-09-15T12:02:42.000Z","pagePropGetterError":{"message":"","name":""}},"slug":"/products/custody/compliance/travel-rule/incoming","userData":{"isAuthenticated":false,"teams":["anonymous"]},"isPublic":true}