Skip to content

Ripple Custody integrates with Notabene to enable Travel Rule compliance for digital asset transfers. This integration automates the exchange of required customer information between Virtual Asset Service Providers (VASPs) during transactions.

Travel Rule compliance is available in Ripple Custody v1.30 and later.

Why Travel Rule matters

When you send or receive digital assets above certain thresholds, regulators require you to exchange customer information with the counterparty. This is the Travel Rule — FATF Recommendation 16 — and it applies to VASPs globally.

Without Travel Rule compliance:

  • Transactions may be blocked or delayed by counterparties
  • Your organization risks regulatory penalties
  • You cannot operate in jurisdictions with strict Travel Rule enforcement

Ripple Custody handles this automatically through its Notabene integration, so your transactions flow smoothly while meeting regulatory requirements.

Key concepts

VASPs and the Notabene network

A VASP (Virtual Asset Service Provider) is any business providing custody, exchange, or transfer services for digital assets. VASPs must exchange customer information for transactions above regulatory thresholds.

Notabene operates a global network connecting VASPs for Travel Rule compliance. When you send assets to another VASP on the network, Notabene facilitates the secure exchange of required information. Your organization is identified on this network by a DID (Decentralized Identifier)—a unique identifier like did:web:your-domain.com.

IVMS-101 data format

Customer information is exchanged using the IVMS-101 standard (Inter-VASP Messaging Standard). This includes:

  • Natural persons: Name, address, date of birth
  • Legal entities: Business name, registration number, address
  • Account information: Wallet addresses, account identifiers

PII encryption

Customer data (PII) must be encrypted before transmission. You have two options:

  • Plaintext submission: Submit PII in IVMS-101 format and Notabene encrypts it
  • Pre-encrypted submission: Encrypt PII yourself using Notabene's hybrid encryption (AES-256-GCM + RSA-2048/ECIES) for end-to-end encryption

Ripple Custody does not store or encrypt PII.

How it works

Travel Rule compliance integrates with existing transaction workflows in Ripple Custody:

Customer Request

Compliance Service

Transaction Screening
(Chainalysis/Elliptic)

Travel Rule
(Notabene)

Combined Decision

Transaction Execution

Customer Request

Compliance Service

Transaction Screening
(Chainalysis/Elliptic)

Travel Rule
(Notabene)

Combined Decision

Transaction Execution

For outgoing transactions:

  1. Create a Travel Rule message with counterparty information
  2. Create a transfer intent using the returned suggestedIntentId
  3. System runs screening and Travel Rule checks in parallel
  4. If PII is required, you submit it via the API
  5. Transaction executes when both checks pass

For incoming transactions:

  1. Indexer detects incoming transfer
  2. Funds are quarantined pending compliance checks
  3. System notifies the originating VASP via Notabene
  4. Transaction releases when checks pass

Compliance decisions

Ripple Custody evaluates both risk screening and Travel Rule results. The strictest outcome determines the final decision:

Combined ResultDecision
Both passAUTO_APPROVED — Transaction executes
Either flaggedFLAGGED — Manual review required
Either rejectedAUTO_REJECTED — Transaction blocked

Supported blockchains

BlockchainNative AssetCAIP-19 Identifier
BitcoinBTCbip122:000000000019d6689c085ae165831e93/slip44:0
EthereumETHeip155:1/slip44:60
XRP LedgerXRPxrpl:mainnet/slip44:144
PolygonMATICeip155:137/slip44:966
StellarXLMstellar:pubnet/slip44:148
SolanaSOLsolana:mainnet/slip44:501
TRONTRXtron:mainnet/slip44:195

For tokens, use the format: {chain}/erc20:{contractAddress} (ERC-20), solana:mainnet/spl:{address} (SPL), or stellar:pubnet/asset:{code}:{issuer} (Stellar).

Getting started

  1. Register with Notabene — Complete VASP registration and KYB verification
  2. Configure credentials — Provide your Notabene API credentials to your Ripple partner engineer
  3. Register addresses — Wallet addresses are registered with Notabene

For detailed setup instructions, see Travel Rule setup.

For transaction workflows with API examples, see Travel Rule API.

Glossary

TermDefinition
VASPVirtual Asset Service Provider — a business providing custody, exchange, or transfer services
DIDDecentralized Identifier — unique identifier for VASPs on Notabene (e.g., did:web:domain.com)
DIDdocDID Document — contains public keys for PII encryption and VASP discovery
IVMS-101Inter-VASP Messaging Standard — structured format for customer data exchange
PIIPersonally Identifiable Information — customer data required for Travel Rule
CAIP-19Chain Agnostic Identifier Protocol — standard for identifying assets across blockchains
FATFFinancial Action Task Force — international body setting AML/CFT standards
Recommendation 16FATF guidance requiring VASPs to exchange originator/beneficiary information

Travel Rule requirements vary by jurisdiction. This documentation provides technical guidance only. Consult legal counsel for regulatory advice.


Next steps