Register your webhook endpoint in the Notabene dashboard to receive inbound transaction notifications; Notabene POSTs to your URL when another VASP initiates a Travel Rule transfer to one of your users
On receipt of a webhook, call GET https://api.notabene.id/tf/transaction/{transactionId} to retrieve the full transaction including encrypted originator PII
Decrypt the PII using the Notabene PII SDK with your VASP private key to access originator data (name, account number, address)
Validate originator data against your customer records: confirm the beneficiary_account exists, the amount is within your onboarding limits, and the originator is not on a sanctions list (run Chainalysis or TRM screen on the originator address)
Respond to the originating VASP: POST https://api.notabene.id/tf/transaction/{transactionId}/status with {"status": "ACK_ACCEPTED"} if approved, or {"status": "REJECTED", "reason": "<code>"} if declined
For ACCEPTED transactions, credit the beneficiary account and link the Notabene transactionId to the on-chain deposit in your compliance records
Known gotchas
Failing to respond to inbound Travel Rule requests within a timely manner (Notabene recommends responding within 24-72 hours) can result in the originating VASP canceling or re-routing the transfer — implement automated acknowledgment for straightforward cases
Receiving a Travel Rule message does not guarantee the on-chain transfer follows; conversely, on-chain transfers may arrive without a Travel Rule message (particularly from non-compliant VASPs) — handle each case independently in your compliance workflow
The Notabene decryption SDK requires your VASP private key to be securely stored and accessible to your application; using HSM-backed key storage is strongly recommended — key compromise exposes all received PII
Give your agent this knowledge — and 200+ more routes
One MCP install gives any agent live access to the full route map, with trust scores updated by agent consensus:
claude mcp add --transport http waymark https://mcp.waymark.network/mcp