Overview
Notabene is a compliance platform for crypto and virtual asset businesses that helps Virtual Asset Service Providers (VASPs) meet the FATF Travel Rule. It lets teams identify counterparty VASPs, exchange originator and beneficiary information in the IVMS101 format, and manage the authorization and settlement of crypto transfers so they can move funds while staying compliant with global regulations. Persona’s Notabene integration allows you to create crypto transfers and attach Travel Rule data to them directly from your Persona workflows, connecting identity verification outcomes to Travel Rule compliance.
Benefits
Connect Identity to Travel Rule Compliance: Create a Notabene transfer as soon as a Persona verification confirms the originator’s identity, tying the transfer record back to a verified user.
Automate Counterparty Identification: Notabene identifies the counterparty VASP from the agents you supply when creating a transfer, removing a manual lookup step from your compliance workflow.
Keep Sensitive Data Encrypted: Append IVMS101 originator and beneficiary data to a transfer and Notabene encrypts the personally identifiable information before routing it to the counterparty VASP.
Support Multi-Region Operations: Route requests to the EU or US region depending on where your entity is registered.
Integration Features
Persona’s Notabene integration enables automation across Travel Rule transfer workflows. Key capabilities include:
- Create a Transfer: Create a new crypto transfer for a given entity (VASP), with Notabene identifying the counterparty.
- Append Travel Rule Data to Transfer: Attach IVMS101 originator and beneficiary information to an existing transfer.
Setting up the Notabene integration
Prerequisites
To set up the Notabene integration, ensure you have:
- A Notabene account with an onboarded entity (VASP)
- OAuth2 client credentials (Client ID and Client Secret) issued by Notabene
- Your entity’s Decentralized Identifier (DID) — for example
did:web:withpersonacom-00aff.sandbox.notabene.id:us - Knowledge of which Notabene region your entity is registered in (EU or US)
Setting up the Notabene credentials
- In the Persona Dashboard, navigate to Integrations > Marketplace and click on Notabene.
- Click on Add Credential at the top of the page.
- Enter a Nickname for Credential in the modal, along with your Notabene Client ID and Client Secret, and click Continue.
- Once complete, the credential will appear in Persona and can be selected in workflows.
Using the Notabene integration in a workflow
- Create a new workflow, or open an existing workflow you’d like to update.
- Add a new action step > Integrations.
- Select the Notabene integration and choose your Notabene credential.
- Select the operation you want to run and map Persona data into the input fields.
- Save and publish the workflow.
Notabene Operations Overview
Persona supports the Notabene API operations for creating transfers and attaching Travel Rule data. Use Create a Transfer first, then pass the returned transfer ID into Append Travel Rule Data to Transfer.
See below for a comprehensive list of available Workflow Action steps and possible configurations for the Notabene integration:
Create a Transfer
Creates a new crypto transfer for the given entity (VASP). Notabene identifies the counterparty VASP from the supplied agents and returns the created transfer, including its unique ID and status.
Configuration Steps:
- Provide values for required fields:
- Entity DID (the DID of the entity creating the transfer)
- Originator
- Beneficiary
- Asset (CAIP-19 format, e.g.
eip155:1/slip44:60) - Amount (decimal string, in the asset’s base units)
- Agents
- Reference (your own unique reference, 1–64 characters — letters, numbers, hyphen, underscore)
- Optionally add:
- Settlement ID (the settlement transaction hash, in CAIP-220 format)
- Memo Tag (destination/memo tag for the settlement address)
- Transaction Value (fiat amount + ISO 4217 currency code)
Append Travel Rule Data to Transfer
Attaches IVMS101 originator and beneficiary information to an existing crypto transfer. Notabene validates the submitted data against the counterparty’s presentation definition, encrypts the PII, and routes it to the correct counterparty VASP. The transfer must already exist and be a Travel Rule transfer before data can be appended.
Configuration Steps:
- Provide values for required fields:
- Entity DID (the DID of the entity that owns the transfer)
- Transfer ID (from Create a Transfer)
- IVMS101 Payload (originator and beneficiary details, plus payload metadata such as IVMS101 version)
FAQs
What order do I call these two operations in?
Always call Create a Transfer first. Notabene returns a transfer ID, which you then pass into Append Travel Rule Data to Transfer along with the IVMS101 payload.
Which regions does this integration support?
Notabene entities are registered in either the EU or US region — Persona routes API calls to api.eu1.notabene.id or api.us1.notabene.id accordingly based on your entity’s setup.
What format does the Asset field expect?
Asset uses CAIP-19 format, for example eip155:1/slip44:60 for ETH on Ethereum mainnet.