This workflow covers detecting and processing incoming deposits with Travel Rule compliance. Ripple Custody automatically handles most of this process.
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 status to decide whether to release the quarantined funds.
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.
- Travel Rule setup complete
- Wallet addresses registered with Notabene (Ripple Custody does this automatically when you connect your Notabene account and when you create new wallets)
When an incoming transaction is detected on the blockchain, Ripple Custody automatically:
- Detects the incoming transfer.
- Quarantines the funds pending compliance checks.
No action required — this is automatic.
If transaction screening is configured (Chainalysis or Elliptic), Ripple Custody screens the transaction first.
- If screening fails (high risk score): The transaction is immediately rejected. No Travel Rule check occurs.
- If screening passes: The workflow proceeds to the Travel Rule check.
Ripple Custody searches your Notabene account for an incoming Travel Rule message that matches the transaction hash:
- If a matching message exists: Ripple Custody polls Notabene for the message status until it reaches a final state (for example,
AUTHORIZED,SETTLED,REJECTED, orFLAGGED). It retrieves only the status. The PII payload stays in Notabene. - If no matching message exists: There isn't enough counterparty data to complete the check. The transfer enters
NEED_EXPLICIT_DECISIONand requires manual review (see Handle "no data" scenarios).
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.
Ripple Custody evaluates the results:
| Screening Result | Travel Rule Result | Decision |
|---|---|---|
| Approved | Approved | AUTO_APPROVED |
| Rejected | — | AUTO_REJECTED (Travel Rule skipped) |
| Approved | Rejected | AUTO_REJECTED |
| Inconclusive | Inconclusive | NEED_EXPLICIT_DECISION |
If only one check is configured (screening only or Travel Rule only), the decision is based on that single check.
If AUTO_APPROVED:
- Funds are released from quarantine.
- After on-chain settlement, Notabene is notified.
If AUTO_REJECTED:
- Funds remain quarantined.
- Notabene is notified of rejection.
If NEED_EXPLICIT_DECISION: Funds remain quarantined. Manual review is required in Ripple Custody (see below).
When an incoming transfer arrives but the originating VASP has not provided Travel Rule data, the transfer may enter NEED_EXPLICIT_DECISION status, requiring manual handling.
After manual review in Ripple Custody, the compliance team can approve or reject the transfer:
- Approved: Funds are released and Notabene is notified after on-chain settlement.
- Rejected: Funds remain quarantined and Notabene is notified of rejection.
- Send without PII — Outgoing transfers when PII is not required.
- Send with PII — Outgoing transfers when PII is required.