Notification webhook
Breaking change
Removing PII data from notification webhook
As of October 1 2024, we will remove the PII information from the webhook data.
If you want to get the PII, it needs to be requested using txInfo instead.
Please see here for more details
Old payload
{
"message": "notification.transactionUpdated",
"payload": {
"transaction": {
"amountInLocalCurrency": null,
"beneficiaryAmountInLocalCurrency": {
"amountInLocalCurrency": 3346610000000,
"currency": "SGD"
},
"beneficiaryDid": "did:key:z6MkrGo9qMTPyGkxcLdXp7RUj62iNN2n6wcL8dWfUF2ADopQ",
"beneficiaryProof": null,
"beneficiaryVASPdid": "did:ethr:0x940a4b2a0932733b842e4aa906761bb3d3bd8148",
"chargedQuantity": 2489840000000,
"createdAt": "2024-02-12T09:15:12.818Z",
"createdBy": "did:ethr:0x001e08558de3663ea207da6eb5906988d012bff9",
"custom_asset_price": null,
"id": "7e81cb52-7e32-430c-9130-4c0c59d97640",
"isTest": null,
"ivms101": {
"beneficiary": {
"accountNumber": [
"1j1DxijjjjnjjnAQiUXPwwwq5KqUjnuwwwwwnujujuXU5RxQQywwwNiNUh5"
],
"beneficiaryPersons": [
{
"naturalPerson": {
"name": [
{
"nameIdentifier": [
{
"nameIdentifierType": "LEGL"
}
]
}
]
}
}
]
},
"beneficiaryVASP": {
"beneficiaryVASP": {
"legalPerson": {
"name": {
"nameIdentifier": [
{
"legalPersonName": "GoodbyeFiat",
"legalPersonNameIdentifierType": "LEGL"
}
]
}
}
}
},
"originatingVASP": {
"originatingVASP": {
"legalPerson": {
"name": {
"nameIdentifier": [
{
"legalPersonName": "Mik Company",
"legalPersonNameIdentifierType": "LEGL"
}
]
}
}
}
},
"originator": {
"originatorPersons": [
{
"naturalPerson": {
"name": [
{
"nameIdentifier": [
{
"nameIdentifierType": "LEGL"
}
]
}
]
}
}
]
}
},
"ivms101Encrypted": null,
"on_behalf_of_myself": false,
"originatorDid": "did:key:z6MkvKxTM6G8zXiMhgNZ79w8XY1TUzDMFSChzi24nQTfJXxA",
"originatorProof": null,
"originatorVASPdid": "did:ethr:0x270d4f239359471f1d1c80781a53cf8105f7d08f",
"pii": {
"beneficiary": {
"accountNumber": [
"QmW5rcEuRRBoS4WU65xJirpwthdRbE6GbySnP9eb5F8AnS"
],
"beneficiaryPersons": [
{
"naturalPerson": {
"name": [
{
"nameIdentifier": [
{
"nameIdentifierType": "QmXWb7jobBKEMmZTYeyzhigaGgMfvuyZy9K7Q1xGoyTCbD"
}
]
}
]
}
}
]
},
"beneficiaryVASP": {
"beneficiaryVASP": {
"legalPerson": {
"name": {
"nameIdentifier": [
{
"legalPersonName": "QmPWzqYEgf71QceKbJinuhD3bYmyu7ziC4sREY7d9MU97J",
"legalPersonNameIdentifierType": "QmdEZ2aLdWb7T7FwojjoZT6MeifUESPCywEQgk236ziP1q"
}
]
}
}
}
},
"originatingVASP": {
"originatingVASP": {
"legalPerson": {
"name": {
"nameIdentifier": [
{
"legalPersonName": "QmbcQh64KazNJbkQ6iEcEVMwnSii7gH2ftLg2bYnadJjiK",
"legalPersonNameIdentifierType": "QmYJ5Z8vTQjKDJQQepfcqKp2YySqe8votgWwG8YPASPaX4"
}
]
}
}
}
},
"originator": {
"originatorPersons": [
{
"naturalPerson": {
"name": [
{
"nameIdentifier": [
{
"nameIdentifierType": "QmYymb5c9k25jvXpesyfRY5DHFwdhEJQNczts3hH9S9EXx"
}
]
}
]
}
}
]
}
},
"pii_url": null,
"protocol": "TRLight",
"protocolData": null,
"showToBeneficiary": null,
"status": "INCOMPLETE",
"tracked_billing": true,
"transactionAmount": "1000000000000000000000000000",
"transactionAsset": "ETH",
"transactionBlockchainInfo": {
"destination": "1j1DxijjjjnjjnAQiUXPwwwq5KqUjnuwwwwwnujujuXU5RxQQywwwNiNUh5",
"txHash": "a259833ookowwwwkkl33a7-c289-omkewwwqeeemkmk498f-9c37-5dqqqd98931ssds8ff6"
},
"transactionRef": null,
"transactionType": "TRAVELRULE",
"updatedAt": "2024-02-12T09:16:59.292Z",
"updatedBy": "did:ethr:0x001e08558de3663ea207da6eb5906988d012bff9"
}
},
"version": "1.0.0"
}
New payload:
{
"message": "notification.transactionUpdated",
"payload": {
"transaction": {
"amountInLocalCurrency": null,
"beneficiaryAmountInLocalCurrency": {
"amountInLocalCurrency": 3346610000000,
"currency": "SGD"
},
"beneficiaryDid": "did:key:z6MkrGo9qMTPyGkxcLdXp7RUj62iNN2n6wcL8dWfUF2ADopQ",
"beneficiaryProof": null,
"beneficiaryVASPdid": "did:ethr:0x940a4b2a0932733b842e4aa906761bb3d3bd8148",
"chargedQuantity": 2489840000000,
"createdAt": "2024-02-12T09:15:12.818Z",
"createdBy": "did:ethr:0x001e08558de3663ea207da6eb5906988d012bff9",
"custom_asset_price": null,
"id": "7e81cb52-7e32-430c-9130-4c0c59d97640",
"isTest": null,
"ivms101Encrypted": null,
"on_behalf_of_myself": false,
"originatorDid": "did:key:z6MkvKxTM6G8zXiMhgNZ79w8XY1TUzDMFSChzi24nQTfJXxA",
"originatorProof": null,
"originatorVASPdid": "did:ethr:0x270d4f239359471f1d1c80781a53cf8105f7d08f",
"pii_url": null,
"protocol": "TRLight",
"protocolData": null,
"showToBeneficiary": null,
"status": "INCOMPLETE",
"tracked_billing": true,
"transactionAmount": "1000000000000000000000000000",
"transactionAsset": "ETH",
"transactionBlockchainInfo": {
"destination": "1j1DxijjjjnjjnAQiUXPwwwq5KqUjnuwwwwwnujujuXU5RxQQywwwNiNUh5",
"txHash": "a259833ookowwwwkkl33a7-c289-omkewwwqeeemkmk498f-9c37-5dqqqd98931ssds8ff6"
},
"transactionRef": null,
"transactionType": "TRAVELRULE",
"updatedAt": "2024-02-12T09:16:59.292Z",
"updatedBy": "did:ethr:0x001e08558de3663ea207da6eb5906988d012bff9"
}
},
"version": "1.0.0"
}
How to set up the Notification Webhook
See here how to set up the Notification Webhook
What is the Notification Webhook
Every time a travel rule transaction is created, received, or changes its status, Notabene can notify the originator and beneficiary VASP (when applicable) via a Webhook.
In the body of the webhook, you will have a message and a payload:
{
"message": "notification.transactionUpdated",
"payload": {
"transaction": "..."
},
"version": "1.0.0"
}
To register your webhook endpoint, use the Notabene UI.
Statuses
The webhook can push any status listed here in the yellow bubbles.
Every time a status changes, it pushes a new updated copy of the travel rule message.
NEW
When you create a travel rule message, the webhook will push the full details:
{"message":"notification.transactionUpdated","payload":{"transaction":{"amountInLocalCurrency":{"amountInLocalCurrency":4364.179,"currency":"SGD"},"beneficiaryAmountInLocalCurrency":{"amountInLocalCurrency":3055.768,"currency":"EUR"},"beneficiaryDid":"did:ethr:0xcc191cf62e96769fbedf7eecde3446a9b2f4a766","beneficiaryProof":null,"beneficiaryVASPdid":"did:ethr:0x54768b1da0c6f1bd0fda15dc6c55cbba40f85744","blockchainTransactionTimestamp":null,"chargedQuantity":3350.342,"createdAt":"2024-10-07T09:48:37.043Z","createdBy":"did:ethr:0xfc929b9607b991980a49b84a0be28a698d863241","custom_asset_price":null,"id":"301e0e47-3e8a-43d6-b364-6c9f113317ad","isTest":null,"ivms101":{"beneficiaryVASP":{"beneficiaryVASP":{"legalPerson":{"name":{"nameIdentifier":[{"legalPersonName":"Notabene VASP SE","legalPersonNameIdentifierType":"LEGL"}]}}}},"originatingVASP":{"originatingVASP":{"legalPerson":{"name":{"nameIdentifier":[{"legalPersonName":"Notabene VASP SG","legalPersonNameIdentifierType":"LEGL"}]}}}}},"ivms101Encrypted":null,"on_behalf_of_myself":false,"originatorDid":"did:key:z6MkfZfFdd3suTaqUBTSNWDtrfdM7xicvZVi8yiZ9WZaqpZC","originatorProof":null,"originatorVASPdid":"did:ethr:0xd4bd902ec78578f33a20ff601504d2ab324cfab9","pii":{"beneficiaryVASP":{"beneficiaryVASP":{"legalPerson":{"name":{"nameIdentifier":[{"legalPersonName":"Qmf5xoztZNyCwbrajVKWfXWGfkcCvWcxHnmi7aZkovPEgk","legalPersonNameIdentifierType":"QmSZXohyPgCUAKyTuHxQVHRcZuD9wvUp6BrBo3g37AybcQ"}]}}}},"originatingVASP":{"originatingVASP":{"legalPerson":{"name":{"nameIdentifier":[{"legalPersonName":"QmSfqmwQZnAxnps3iQXCqRk8oHic32jcNcLw1XhS6Dbk3c","legalPersonNameIdentifierType":"QmcYyY5pMA7yAEtRJzhqXcKyt3Z6tobT3VFaG3jER6gsV6"}]}}}}},"pii_url":"https://pii.notabene.dev/","protocol":"TRLight","protocolData":{"trLightData":{"accessLinks":[],"notificationEmails":[]}},"showToBeneficiary":null,"status":"NEW","tracked_billing":false,"transactionAmount":"5300000","transactionAsset":"BTC","transactionBlockchainInfo":{"destination":"1bb1ambJPRvYs9GwgVNcA4VgY","origin":"1CywRTUgZL9WVs4atBiUpsw32H4Ezi"},"transactionRef":"381cf57d-bec2-4a14-9b7e-f88ed218eb97","transactionType":"TRAVELRULE","updatedAt":"2024-10-07T09:48:37.082Z","updatedBy":"did:ethr:0xfc929b9607b991980a49b84a0be28a698d863241"}},"version":"1.0.0"}
SENT
When you have an incoming travel rule message, it will have the status "SENT" and you get information about the transaction itself and the beneficiary person:
{"message":"notification.transactionUpdated","payload":{"transaction":{"actions":[{"action":"approve","actionData":"{\"vaspDID\":\"did:ethr:0xd4bd902ec78578f33a20ff601504d2ab324cfab9\",\"callSource\":\"api\"}","createdAt":"2024-10-07T09:55:53.600Z","createdBy":"did:ethr:0xfc929b9607b991980a49b84a0be28a698d863241","hash":"1ec4b6cfec09dd060002f976fc9f13a0cb428608a4b6960c3672fb84b17a5f092c9bf458010ad34f4533afba5e4ba5c1e49b3d8fddd5cfaafaf45538d899c902","issuerDID":"did:ethr:0xfc929b9607b991980a49b84a0be28a698d863241","transactionId":"301e0e47-3e8a-43d6-b364-6c9f113317ad"},{"action":"create","actionData":"{\"transactionRef\":\"381cf57d-bec2-4a14-9b7e-f88ed218eb97\",\"transactionAsset\":\"BTC\",\"transactionAssetDecimals\":8,\"transactionAmount\":\"5300000\",\"originatorVASPdid\":\"did:ethr:0xd4bd902ec78578f33a20ff601504d2ab324cfab9\",\"beneficiaryVASPdid\":\"did:ethr:0x54768b1da0c6f1bd0fda15dc6c55cbba40f85744\",\"beneficiaryRef\":\"[email protected]\",\"originatorRef\":\"[email protected]\",\"transactionBlockchainInfo\":{\"origin\":\"1CywRTUgZL9WVs4atBiUpsw32H4Ezi\",\"destination\":\"1bb1ambJPRvYs9GwgVNcA4VgY\"},\"originatorDid\":\"did:key:z6MkfZfFdd3suTaqUBTSNWDtrfdM7xicvZVi8yiZ9WZaqpZC\",\"beneficiaryDid\":\"did:ethr:0xcc191cf62e96769fbedf7eecde3446a9b2f4a766\",\"callSource\":\"api\",\"vaspDID\":\"did:ethr:0xd4bd902ec78578f33a20ff601504d2ab324cfab9\"}","createdAt":"2024-10-07T09:48:37.216Z","createdBy":"did:ethr:0xfc929b9607b991980a49b84a0be28a698d863241","hash":"741392f30436d026694cba85d99d676ac28dd376b96928cbc5249cec91193dd6054430f4e72cc40de6646671e275b1e4566ae781999835293d9a4036d7b70f1b","issuerDID":"did:ethr:0xfc929b9607b991980a49b84a0be28a698d863241","transactionId":"301e0e47-3e8a-43d6-b364-6c9f113317ad"}],"amountInLocalCurrency":{"amountInLocalCurrency":4364.179,"currency":"SGD"},"beneficiaryAmountInLocalCurrency":{"amountInLocalCurrency":3055.768,"currency":"EUR"},"beneficiaryDid":"did:ethr:0xcc191cf62e96769fbedf7eecde3446a9b2f4a766","beneficiaryProof":null,"beneficiaryVASPdid":"did:ethr:0x54768b1da0c6f1bd0fda15dc6c55cbba40f85744","blockchainTransactionTimestamp":null,"chargedQuantity":3350.342,"createdAt":"2024-10-07T09:48:37.043Z","createdBy":"did:ethr:0xfc929b9607b991980a49b84a0be28a698d863241","custom_asset_price":null,"id":"301e0e47-3e8a-43d6-b364-6c9f113317ad","isTest":null,"ivms101":{"beneficiaryVASP":{"beneficiaryVASP":{"legalPerson":{"name":{"nameIdentifier":[{"legalPersonName":"Notabene VASP SE","legalPersonNameIdentifierType":"LEGL"}]}}}},"originatingVASP":{"originatingVASP":{"legalPerson":{"name":{"nameIdentifier":[{"legalPersonName":"Notabene VASP SG","legalPersonNameIdentifierType":"LEGL"}]}}}}},"ivms101Encrypted":null,"on_behalf_of_myself":false,"originatorDid":"did:key:z6MkfZfFdd3suTaqUBTSNWDtrfdM7xicvZVi8yiZ9WZaqpZC","originatorProof":null,"originatorVASPdid":"did:ethr:0xd4bd902ec78578f33a20ff601504d2ab324cfab9","pii":{"beneficiaryVASP":{"beneficiaryVASP":{"legalPerson":{"name":{"nameIdentifier":[{"legalPersonName":"Qmf5xoztZNyCwbrajVKWfXWGfkcCvWcxHnmi7aZkovPEgk","legalPersonNameIdentifierType":"QmSZXohyPgCUAKyTuHxQVHRcZuD9wvUp6BrBo3g37AybcQ"}]}}}},"originatingVASP":{"originatingVASP":{"legalPerson":{"name":{"nameIdentifier":[{"legalPersonName":"QmSfqmwQZnAxnps3iQXCqRk8oHic32jcNcLw1XhS6Dbk3c","legalPersonNameIdentifierType":"QmcYyY5pMA7yAEtRJzhqXcKyt3Z6tobT3VFaG3jER6gsV6"}]}}}}},"pii_url":"https://pii.notabene.dev/","protocol":"TRLight","protocolData":{"trLightData":{"accessLinks":[],"notificationEmails":[]}},"status":"SENT","tracked_billing":false,"transactionAmount":"5300000","transactionAsset":"BTC","transactionBlockchainInfo":{"destination":"1bb1ambJPRvYs9GwgVNcA4VgY","origin":"1CywRTUgZL9WVs4atBiUpsw32H4Ezi"},"transactionRef":"381cf57d-bec2-4a14-9b7e-f88ed218eb97","transactionType":"TRAVELRULE","updatedAt":"2024-10-07T09:55:53.277Z","updatedBy":"did:ethr:0xfc929b9607b991980a49b84a0be28a698d863241"}},"version":"1.0.0"}
ACK/REJECTED
Once you or the beneficiary VASP acknowledge that you/they control the destination address, the status will change to ACK, and you receive the originator information.
If you or they do not control the address and reject it, the status will change to REJECTED:
{"message":"notification.transactionUpdated","payload":{"transaction":{"actions":[{"action":"confirm","actionData":"{\"vaspDID\":\"did:ethr:0x049fc13a4f1e79d4d03f082ca96758179a91da29\",\"callSource\":\"api\"}","createdAt":"2024-10-07T10:01:46.176Z","createdBy":"did:ethr:0xfc929b9607b991980a49b84a0be28a698d863241","hash":"8bb75deefc58c992aae42fe77cd1e987d2356133be76b9e04063efc2ae826d2582709c2a614ccd469e75cfb105169c645ddbb6d0381cf3064c689a51923e67cb","issuerDID":"did:ethr:0xfc929b9607b991980a49b84a0be28a698d863241","transactionId":"5e60be94-11b0-4231-893a-ded8ed1fdf48"},{"action":"approve","actionData":"{\"vaspDID\":\"did:ethr:0xd4bd902ec78578f33a20ff601504d2ab324cfab9\",\"callSource\":\"api\"}","createdAt":"2024-10-07T10:01:01.745Z","createdBy":"did:ethr:0xfc929b9607b991980a49b84a0be28a698d863241","hash":"65f72dedf0b81c7b794af9b8239f56afab058ac50caf614a09652b9b8a5a0b90065eb46982dede2a7661349cc2332ba4b194ee78c207825acbc8f18828442b48","issuerDID":"did:ethr:0xfc929b9607b991980a49b84a0be28a698d863241","transactionId":"5e60be94-11b0-4231-893a-ded8ed1fdf48"},{"action":"create","actionData":"{\"transactionRef\":\"96b39bda-3617-4dea-93fd-8c10dc1a383a\",\"transactionAsset\":\"BTC\",\"transactionAssetDecimals\":8,\"transactionAmount\":\"82700000\",\"originatorVASPdid\":\"did:ethr:0xd4bd902ec78578f33a20ff601504d2ab324cfab9\",\"beneficiaryVASPdid\":\"did:ethr:0x049fc13a4f1e79d4d03f082ca96758179a91da29\",\"beneficiaryRef\":\"[email protected]\",\"originatorRef\":\"[email protected]\",\"transactionBlockchainInfo\":{\"origin\":\"1DbotH8QZ1NXD78R64vHvGp9YzHND5Ts\",\"destination\":\"3WQ8RqWsdy1DPvWGRn9VKVcgnbUKkKg\"},\"originatorDid\":\"did:key:z6MkfZfFdd3suTaqUBTSNWDtrfdM7xicvZVi8yiZ9WZaqpZC\",\"beneficiaryDid\":\"did:ethr:0xcc191cf62e96769fbedf7eecde3446a9b2f4a766\",\"callSource\":\"api\",\"vaspDID\":\"did:ethr:0xd4bd902ec78578f33a20ff601504d2ab324cfab9\"}","createdAt":"2024-10-07T10:00:57.464Z","createdBy":"did:ethr:0xfc929b9607b991980a49b84a0be28a698d863241","hash":"85dadae8b2a933cf85185549bcbf5bfdbe6e391a39678d90280bdc3c454887c2096f6379b421a482e46148cc07afd3c03dd31da58b200260c0ad0dea1686ecaf","issuerDID":"did:ethr:0xfc929b9607b991980a49b84a0be28a698d863241","transactionId":"5e60be94-11b0-4231-893a-ded8ed1fdf48"}],"amountInLocalCurrency":{"amountInLocalCurrency":68180.36099999999,"currency":"SGD"},"beneficiaryAmountInLocalCurrency":{"amountInLocalCurrency":47690.609,"currency":"EUR"},"beneficiaryDid":"did:ethr:0xcc191cf62e96769fbedf7eecde3446a9b2f4a766","beneficiaryProof":null,"beneficiaryVASPdid":"did:ethr:0x049fc13a4f1e79d4d03f082ca96758179a91da29","blockchainTransactionTimestamp":null,"chargedQuantity":52259.784,"createdAt":"2024-10-07T10:00:57.230Z","createdBy":"did:ethr:0xfc929b9607b991980a49b84a0be28a698d863241","custom_asset_price":null,"id":"5e60be94-11b0-4231-893a-ded8ed1fdf48","isTest":null,"ivms101":{"beneficiaryVASP":{"beneficiaryVASP":{"legalPerson":{"name":{"nameIdentifier":[{"legalPersonName":"Notabene VASP EE","legalPersonNameIdentifierType":"LEGL"}]}}}},"originatingVASP":{"originatingVASP":{"legalPerson":{"name":{"nameIdentifier":[{"legalPersonName":"Notabene VASP SG","legalPersonNameIdentifierType":"LEGL"}]}}}}},"ivms101Encrypted":null,"on_behalf_of_myself":false,"originatorDid":"did:key:z6MkfZfFdd3suTaqUBTSNWDtrfdM7xicvZVi8yiZ9WZaqpZC","originatorProof":null,"originatorVASPdid":"did:ethr:0xd4bd902ec78578f33a20ff601504d2ab324cfab9","pii":{"beneficiaryVASP":{"beneficiaryVASP":{"legalPerson":{"name":{"nameIdentifier":[{"legalPersonName":"QmcbmuVehCtjLv5hQfoKqtxdP5svezpDMhbu5SQwhtvM9b","legalPersonNameIdentifierType":"QmYZd5EA2SdrScd11G435ZknfVDHVTKA3oaPDnQLBqt5VS"}]}}}},"originatingVASP":{"originatingVASP":{"legalPerson":{"name":{"nameIdentifier":[{"legalPersonName":"QmagFv5rU9CogwdgmRBBxbWoQ8GBHw6aZSwjKxWH4wYDdE","legalPersonNameIdentifierType":"QmTGE2RgEkVuswSnvee1REEvxRrySzF5uzh5hduyvHBMDw"}]}}}}},"pii_url":"https://pii.notabene.dev/","protocol":"TRLight","protocolData":{"trLightData":{"accessLinks":[],"notificationEmails":[]}},"status":"ACK","tracked_billing":false,"transactionAmount":"82700000","transactionAsset":"BTC","transactionBlockchainInfo":{"destination":"3WQ8RqWsdy1DPvWGRn9VKVcgnbUKkKg","origin":"1DbotH8QZ1NXD78R64vHvGp9YzHND5Ts"},"transactionRef":"96b39bda-3617-4dea-93fd-8c10dc1a383a","transactionType":"TRAVELRULE","updatedAt":"2024-10-07T10:01:45.947Z","updatedBy":"did:ethr:0xfc929b9607b991980a49b84a0be28a698d863241"}},"version":"1.0.0"}
{"message":"notification.transactionUpdated","payload":{"transaction":{"actions":[{"action":"reject","actionData":"{\"rejectedBy\":\"address-webhook\",\"isInBulk\":false,\"vaspDID\":\"did:ethr:0x54768b1da0c6f1bd0fda15dc6c55cbba40f85744\",\"callSource\":\"auto\"}","createdAt":"2024-10-07T09:55:56.758Z","createdBy":"did:ethr:0x19b5ff8440019b635a86bbb632db854f2ea80423","hash":"e945f915fc464c4dc78472ba6e84215ef937a1772b0d166954fa6a7b233a2ea6bf8b29e7063d8a42c52e6ba3982144d41819defbd13729ab189b48a769fb7db1","issuerDID":"did:ethr:0x19b5ff8440019b635a86bbb632db854f2ea80423","transactionId":"301e0e47-3e8a-43d6-b364-6c9f113317ad"},{"action":"approve","actionData":"{\"vaspDID\":\"did:ethr:0xd4bd902ec78578f33a20ff601504d2ab324cfab9\",\"callSource\":\"api\"}","createdAt":"2024-10-07T09:55:53.600Z","createdBy":"did:ethr:0xfc929b9607b991980a49b84a0be28a698d863241","hash":"1ec4b6cfec09dd060002f976fc9f13a0cb428608a4b6960c3672fb84b17a5f092c9bf458010ad34f4533afba5e4ba5c1e49b3d8fddd5cfaafaf45538d899c902","issuerDID":"did:ethr:0xfc929b9607b991980a49b84a0be28a698d863241","transactionId":"301e0e47-3e8a-43d6-b364-6c9f113317ad"},{"action":"create","actionData":"{\"transactionRef\":\"381cf57d-bec2-4a14-9b7e-f88ed218eb97\",\"transactionAsset\":\"BTC\",\"transactionAssetDecimals\":8,\"transactionAmount\":\"5300000\",\"originatorVASPdid\":\"did:ethr:0xd4bd902ec78578f33a20ff601504d2ab324cfab9\",\"beneficiaryVASPdid\":\"did:ethr:0x54768b1da0c6f1bd0fda15dc6c55cbba40f85744\",\"beneficiaryRef\":\"[email protected]\",\"originatorRef\":\"[email protected]\",\"transactionBlockchainInfo\":{\"origin\":\"1CywRTUgZL9WVs4atBiUpsw32H4Ezi\",\"destination\":\"1bb1ambJPRvYs9GwgVNcA4VgY\"},\"originatorDid\":\"did:key:z6MkfZfFdd3suTaqUBTSNWDtrfdM7xicvZVi8yiZ9WZaqpZC\",\"beneficiaryDid\":\"did:ethr:0xcc191cf62e96769fbedf7eecde3446a9b2f4a766\",\"callSource\":\"api\",\"vaspDID\":\"did:ethr:0xd4bd902ec78578f33a20ff601504d2ab324cfab9\"}","createdAt":"2024-10-07T09:48:37.216Z","createdBy":"did:ethr:0xfc929b9607b991980a49b84a0be28a698d863241","hash":"741392f30436d026694cba85d99d676ac28dd376b96928cbc5249cec91193dd6054430f4e72cc40de6646671e275b1e4566ae781999835293d9a4036d7b70f1b","issuerDID":"did:ethr:0xfc929b9607b991980a49b84a0be28a698d863241","transactionId":"301e0e47-3e8a-43d6-b364-6c9f113317ad"}],"amountInLocalCurrency":{"amountInLocalCurrency":4364.179,"currency":"SGD"},"beneficiaryAmountInLocalCurrency":{"amountInLocalCurrency":3055.768,"currency":"EUR"},"beneficiaryDid":"did:ethr:0xcc191cf62e96769fbedf7eecde3446a9b2f4a766","beneficiaryProof":null,"beneficiaryVASPdid":"did:ethr:0x54768b1da0c6f1bd0fda15dc6c55cbba40f85744","blockchainTransactionTimestamp":null,"chargedQuantity":3350.342,"createdAt":"2024-10-07T09:48:37.043Z","createdBy":"did:ethr:0xfc929b9607b991980a49b84a0be28a698d863241","custom_asset_price":null,"id":"301e0e47-3e8a-43d6-b364-6c9f113317ad","isTest":null,"ivms101":{"beneficiaryVASP":{"beneficiaryVASP":{"legalPerson":{"name":{"nameIdentifier":[{"legalPersonName":"Notabene VASP SE","legalPersonNameIdentifierType":"LEGL"}]}}}},"originatingVASP":{"originatingVASP":{"legalPerson":{"name":{"nameIdentifier":[{"legalPersonName":"Notabene VASP SG","legalPersonNameIdentifierType":"LEGL"}]}}}}},"ivms101Encrypted":null,"on_behalf_of_myself":false,"originatorDid":"did:key:z6MkfZfFdd3suTaqUBTSNWDtrfdM7xicvZVi8yiZ9WZaqpZC","originatorProof":null,"originatorVASPdid":"did:ethr:0xd4bd902ec78578f33a20ff601504d2ab324cfab9","pii":{"beneficiaryVASP":{"beneficiaryVASP":{"legalPerson":{"name":{"nameIdentifier":[{"legalPersonName":"Qmf5xoztZNyCwbrajVKWfXWGfkcCvWcxHnmi7aZkovPEgk","legalPersonNameIdentifierType":"QmSZXohyPgCUAKyTuHxQVHRcZuD9wvUp6BrBo3g37AybcQ"}]}}}},"originatingVASP":{"originatingVASP":{"legalPerson":{"name":{"nameIdentifier":[{"legalPersonName":"QmSfqmwQZnAxnps3iQXCqRk8oHic32jcNcLw1XhS6Dbk3c","legalPersonNameIdentifierType":"QmcYyY5pMA7yAEtRJzhqXcKyt3Z6tobT3VFaG3jER6gsV6"}]}}}}},"pii_url":"https://pii.notabene.dev/","protocol":"TRLight","protocolData":{"trLightData":{"accessLinks":[],"notificationEmails":[]}},"status":"REJECTED","tracked_billing":false,"transactionAmount":"5300000","transactionAsset":"BTC","transactionBlockchainInfo":{"destination":"1bb1ambJPRvYs9GwgVNcA4VgY","origin":"1CywRTUgZL9WVs4atBiUpsw32H4Ezi"},"transactionRef":"381cf57d-bec2-4a14-9b7e-f88ed218eb97","transactionType":"TRAVELRULE","updatedAt":"2024-10-07T09:55:56.514Z","updatedBy":"did:ethr:0xfc929b9607b991980a49b84a0be28a698d863241"}},"version":"1.0.0"}
ACCEPTED/DECLINED
After sanction screening the originator person and screening the origin address through blockchain analytics, the travel rule is then either ACCEPTED or REJECTED:
{"message":"notification.transactionUpdated","payload":{"transaction":{"actions":[{"action":"accept","actionData":"{\"vaspDID\":\"did:ethr:0x049fc13a4f1e79d4d03f082ca96758179a91da29\",\"callSource\":\"api\"}","createdAt":"2024-10-07T10:02:25.422Z","createdBy":"did:ethr:0xfc929b9607b991980a49b84a0be28a698d863241","hash":"2e8ff83112c755dd385781bdbc6d65abc0c33c29b243313f6c649a05cf2c239ac5c9195666006a54c6caf5d6f0c4bb2cdc87fb50e06005f23c6afa56f3ba097b","issuerDID":"did:ethr:0xfc929b9607b991980a49b84a0be28a698d863241","transactionId":"5e60be94-11b0-4231-893a-ded8ed1fdf48"},{"action":"confirm","actionData":"{\"vaspDID\":\"did:ethr:0x049fc13a4f1e79d4d03f082ca96758179a91da29\",\"callSource\":\"api\"}","createdAt":"2024-10-07T10:01:46.176Z","createdBy":"did:ethr:0xfc929b9607b991980a49b84a0be28a698d863241","hash":"8bb75deefc58c992aae42fe77cd1e987d2356133be76b9e04063efc2ae826d2582709c2a614ccd469e75cfb105169c645ddbb6d0381cf3064c689a51923e67cb","issuerDID":"did:ethr:0xfc929b9607b991980a49b84a0be28a698d863241","transactionId":"5e60be94-11b0-4231-893a-ded8ed1fdf48"},{"action":"approve","actionData":"{\"vaspDID\":\"did:ethr:0xd4bd902ec78578f33a20ff601504d2ab324cfab9\",\"callSource\":\"api\"}","createdAt":"2024-10-07T10:01:01.745Z","createdBy":"did:ethr:0xfc929b9607b991980a49b84a0be28a698d863241","hash":"65f72dedf0b81c7b794af9b8239f56afab058ac50caf614a09652b9b8a5a0b90065eb46982dede2a7661349cc2332ba4b194ee78c207825acbc8f18828442b48","issuerDID":"did:ethr:0xfc929b9607b991980a49b84a0be28a698d863241","transactionId":"5e60be94-11b0-4231-893a-ded8ed1fdf48"},{"action":"create","actionData":"{\"transactionRef\":\"96b39bda-3617-4dea-93fd-8c10dc1a383a\",\"transactionAsset\":\"BTC\",\"transactionAssetDecimals\":8,\"transactionAmount\":\"82700000\",\"originatorVASPdid\":\"did:ethr:0xd4bd902ec78578f33a20ff601504d2ab324cfab9\",\"beneficiaryVASPdid\":\"did:ethr:0x049fc13a4f1e79d4d03f082ca96758179a91da29\",\"beneficiaryRef\":\"[email protected]\",\"originatorRef\":\"[email protected]\",\"transactionBlockchainInfo\":{\"origin\":\"1DbotH8QZ1NXD78R64vHvGp9YzHND5Ts\",\"destination\":\"3WQ8RqWsdy1DPvWGRn9VKVcgnbUKkKg\"},\"originatorDid\":\"did:key:z6MkfZfFdd3suTaqUBTSNWDtrfdM7xicvZVi8yiZ9WZaqpZC\",\"beneficiaryDid\":\"did:ethr:0xcc191cf62e96769fbedf7eecde3446a9b2f4a766\",\"callSource\":\"api\",\"vaspDID\":\"did:ethr:0xd4bd902ec78578f33a20ff601504d2ab324cfab9\"}","createdAt":"2024-10-07T10:00:57.464Z","createdBy":"did:ethr:0xfc929b9607b991980a49b84a0be28a698d863241","hash":"85dadae8b2a933cf85185549bcbf5bfdbe6e391a39678d90280bdc3c454887c2096f6379b421a482e46148cc07afd3c03dd31da58b200260c0ad0dea1686ecaf","issuerDID":"did:ethr:0xfc929b9607b991980a49b84a0be28a698d863241","transactionId":"5e60be94-11b0-4231-893a-ded8ed1fdf48"}],"amountInLocalCurrency":{"amountInLocalCurrency":68180.36099999999,"currency":"SGD"},"beneficiaryAmountInLocalCurrency":{"amountInLocalCurrency":47690.609,"currency":"EUR"},"beneficiaryDid":"did:ethr:0xcc191cf62e96769fbedf7eecde3446a9b2f4a766","beneficiaryProof":null,"beneficiaryVASPdid":"did:ethr:0x049fc13a4f1e79d4d03f082ca96758179a91da29","blockchainTransactionTimestamp":null,"chargedQuantity":52259.784,"createdAt":"2024-10-07T10:00:57.230Z","createdBy":"did:ethr:0xfc929b9607b991980a49b84a0be28a698d863241","custom_asset_price":null,"id":"5e60be94-11b0-4231-893a-ded8ed1fdf48","isTest":null,"ivms101":{"beneficiaryVASP":{"beneficiaryVASP":{"legalPerson":{"name":{"nameIdentifier":[{"legalPersonName":"Notabene VASP EE","legalPersonNameIdentifierType":"LEGL"}]}}}},"originatingVASP":{"originatingVASP":{"legalPerson":{"name":{"nameIdentifier":[{"legalPersonName":"Notabene VASP SG","legalPersonNameIdentifierType":"LEGL"}]}}}}},"ivms101Encrypted":null,"on_behalf_of_myself":false,"originatorDid":"did:key:z6MkfZfFdd3suTaqUBTSNWDtrfdM7xicvZVi8yiZ9WZaqpZC","originatorProof":null,"originatorVASPdid":"did:ethr:0xd4bd902ec78578f33a20ff601504d2ab324cfab9","pii":{"beneficiaryVASP":{"beneficiaryVASP":{"legalPerson":{"name":{"nameIdentifier":[{"legalPersonName":"QmcbmuVehCtjLv5hQfoKqtxdP5svezpDMhbu5SQwhtvM9b","legalPersonNameIdentifierType":"QmYZd5EA2SdrScd11G435ZknfVDHVTKA3oaPDnQLBqt5VS"}]}}}},"originatingVASP":{"originatingVASP":{"legalPerson":{"name":{"nameIdentifier":[{"legalPersonName":"QmagFv5rU9CogwdgmRBBxbWoQ8GBHw6aZSwjKxWH4wYDdE","legalPersonNameIdentifierType":"QmTGE2RgEkVuswSnvee1REEvxRrySzF5uzh5hduyvHBMDw"}]}}}}},"pii_url":"https://pii.notabene.dev/","protocol":"TRLight","protocolData":{"trLightData":{"accessLinks":[],"notificationEmails":[]}},"status":"ACCEPTED","tracked_billing":false,"transactionAmount":"82700000","transactionAsset":"BTC","transactionBlockchainInfo":{"destination":"3WQ8RqWsdy1DPvWGRn9VKVcgnbUKkKg","origin":"1DbotH8QZ1NXD78R64vHvGp9YzHND5Ts"},"transactionRef":"96b39bda-3617-4dea-93fd-8c10dc1a383a","transactionType":"TRAVELRULE","updatedAt":"2024-10-07T10:02:25.160Z","updatedBy":"did:ethr:0xfc929b9607b991980a49b84a0be28a698d863241"}},"version":"1.0.0"}
{"message":"notification.transactionUpdated","payload":{"transaction":{"actions":[{"action":"decline","actionData":"{\"id\":\"76248ee1-e555-43d2-a540-2a4769d76265\",\"reason\":\"SCSI Gorgeous plum Somali\",\"vaspDID\":\"did:ethr:0x049fc13a4f1e79d4d03f082ca96758179a91da29\",\"callSource\":\"api\"}","createdAt":"2024-10-07T10:03:10.369Z","createdBy":"did:ethr:0xfc929b9607b991980a49b84a0be28a698d863241","hash":"221e2f4eb12a7f5c5a2878a3b51d9bce09759d42f067d5fa79b5ab64b480d900e888e2c6ae045b1840d56c634878de2b02ba85a512fccbf24234d41c8c10b52a","issuerDID":"did:ethr:0xfc929b9607b991980a49b84a0be28a698d863241","transactionId":"76248ee1-e555-43d2-a540-2a4769d76265"},{"action":"confirm","actionData":"{\"vaspDID\":\"did:ethr:0x049fc13a4f1e79d4d03f082ca96758179a91da29\",\"callSource\":\"api\"}","createdAt":"2024-10-07T10:03:07.281Z","createdBy":"did:ethr:0xfc929b9607b991980a49b84a0be28a698d863241","hash":"bb94fa5023df717dc51b65847e03d203d997660020aa17599cc434884326b1fe9d7e80eb4eba58e6546e6196a61a0ed7124a6071551d8a5c4aa34d7e8a26cb46","issuerDID":"did:ethr:0xfc929b9607b991980a49b84a0be28a698d863241","transactionId":"76248ee1-e555-43d2-a540-2a4769d76265"},{"action":"approve","actionData":"{\"vaspDID\":\"did:ethr:0xd4bd902ec78578f33a20ff601504d2ab324cfab9\",\"callSource\":\"api\"}","createdAt":"2024-10-07T10:03:04.783Z","createdBy":"did:ethr:0xfc929b9607b991980a49b84a0be28a698d863241","hash":"0a0eebc57205d0b731708b36ffd55f1dee92e275d4ebd8b5346847ea70ef2ec904fd6957274ea551723c0f5d93aa18a20fc820ef797d09b34e2c40fbc6064999","issuerDID":"did:ethr:0xfc929b9607b991980a49b84a0be28a698d863241","transactionId":"76248ee1-e555-43d2-a540-2a4769d76265"},{"action":"create","actionData":"{\"transactionRef\":\"eaf84385-ccf4-40a8-95bf-d91b2eb8e0c2\",\"transactionAsset\":\"BTC\",\"transactionAssetDecimals\":8,\"transactionAmount\":\"15800000\",\"originatorVASPdid\":\"did:ethr:0xd4bd902ec78578f33a20ff601504d2ab324cfab9\",\"beneficiaryVASPdid\":\"did:ethr:0x049fc13a4f1e79d4d03f082ca96758179a91da29\",\"beneficiaryRef\":\"[email protected]\",\"originatorRef\":\"[email protected]\",\"transactionBlockchainInfo\":{\"origin\":\"1N2KuHWjcxnvPpRJUH2rsdr8QviQHW\",\"destination\":\"1JCDfgzS3dnQr8fguLMEWPyPeaCz\"},\"originatorDid\":\"did:key:z6MkfZfFdd3suTaqUBTSNWDtrfdM7xicvZVi8yiZ9WZaqpZC\",\"beneficiaryDid\":\"did:ethr:0xcc191cf62e96769fbedf7eecde3446a9b2f4a766\",\"callSource\":\"api\",\"vaspDID\":\"did:ethr:0xd4bd902ec78578f33a20ff601504d2ab324cfab9\"}","createdAt":"2024-10-07T10:03:02.387Z","createdBy":"did:ethr:0xfc929b9607b991980a49b84a0be28a698d863241","hash":"2206a89aebadebb72c757cd11f99f124eb7d5d367feb39c068dca2ad277e96a3eb156db761c35dce8fb8f3e83445b6bd4b53722e52ab7a2ce07e66aae3346ca2","issuerDID":"did:ethr:0xfc929b9607b991980a49b84a0be28a698d863241","transactionId":"76248ee1-e555-43d2-a540-2a4769d76265"}],"amountInLocalCurrency":{"amountInLocalCurrency":13025.994,"currency":"SGD"},"beneficiaryAmountInLocalCurrency":{"amountInLocalCurrency":9111.386,"currency":"EUR"},"beneficiaryDid":"did:ethr:0xcc191cf62e96769fbedf7eecde3446a9b2f4a766","beneficiaryProof":null,"beneficiaryVASPdid":"did:ethr:0x049fc13a4f1e79d4d03f082ca96758179a91da29","blockchainTransactionTimestamp":null,"chargedQuantity":9984.336,"createdAt":"2024-10-07T10:03:02.230Z","createdBy":"did:ethr:0xfc929b9607b991980a49b84a0be28a698d863241","custom_asset_price":null,"id":"76248ee1-e555-43d2-a540-2a4769d76265","isTest":null,"ivms101":{"beneficiaryVASP":{"beneficiaryVASP":{"legalPerson":{"name":{"nameIdentifier":[{"legalPersonName":"Notabene VASP EE","legalPersonNameIdentifierType":"LEGL"}]}}}},"originatingVASP":{"originatingVASP":{"legalPerson":{"name":{"nameIdentifier":[{"legalPersonName":"Notabene VASP SG","legalPersonNameIdentifierType":"LEGL"}]}}}}},"ivms101Encrypted":null,"on_behalf_of_myself":false,"originatorDid":"did:key:z6MkfZfFdd3suTaqUBTSNWDtrfdM7xicvZVi8yiZ9WZaqpZC","originatorProof":null,"originatorVASPdid":"did:ethr:0xd4bd902ec78578f33a20ff601504d2ab324cfab9","pii":{"beneficiaryVASP":{"beneficiaryVASP":{"legalPerson":{"name":{"nameIdentifier":[{"legalPersonName":"QmcbmuVehCtjLv5hQfoKqtxdP5svezpDMhbu5SQwhtvM9b","legalPersonNameIdentifierType":"QmYZd5EA2SdrScd11G435ZknfVDHVTKA3oaPDnQLBqt5VS"}]}}}},"originatingVASP":{"originatingVASP":{"legalPerson":{"name":{"nameIdentifier":[{"legalPersonName":"QmagFv5rU9CogwdgmRBBxbWoQ8GBHw6aZSwjKxWH4wYDdE","legalPersonNameIdentifierType":"QmTGE2RgEkVuswSnvee1REEvxRrySzF5uzh5hduyvHBMDw"}]}}}}},"pii_url":"https://pii.notabene.dev/","protocol":"TRLight","protocolData":{"trLightData":{"accessLinks":[],"notificationEmails":[]}},"status":"DECLINED","tracked_billing":false,"transactionAmount":"15800000","transactionAsset":"BTC","transactionBlockchainInfo":{"destination":"1JCDfgzS3dnQr8fguLMEWPyPeaCz","origin":"1N2KuHWjcxnvPpRJUH2rsdr8QviQHW"},"transactionRef":"eaf84385-ccf4-40a8-95bf-d91b2eb8e0c2","transactionType":"TRAVELRULE","updatedAt":"2024-10-07T10:03:10.174Z","updatedBy":"did:ethr:0xfc929b9607b991980a49b84a0be28a698d863241"}},"version":"1.0.0"}
When txHash gets added
{"message":"notification.transactionUpdated","payload":{"transaction":{"amountInLocalCurrency":{"amountInLocalCurrency":68180.36099999999,"currency":"SGD"},"beneficiaryAmountInLocalCurrency":{"amountInLocalCurrency":47690.609,"currency":"EUR"},"beneficiaryDid":"did:ethr:0xcc191cf62e96769fbedf7eecde3446a9b2f4a766","beneficiaryProof":null,"beneficiaryVASPdid":"did:ethr:0x049fc13a4f1e79d4d03f082ca96758179a91da29","blockchainTransactionTimestamp":null,"chargedQuantity":52259.784,"createdAt":"2024-10-07T10:00:57.230Z","createdBy":"did:ethr:0xfc929b9607b991980a49b84a0be28a698d863241","custom_asset_price":null,"id":"5e60be94-11b0-4231-893a-ded8ed1fdf48","isTest":null,"ivms101":{"beneficiaryVASP":{"beneficiaryVASP":{"legalPerson":{"name":{"nameIdentifier":[{"legalPersonName":"Notabene VASP EE","legalPersonNameIdentifierType":"LEGL"}]}}}},"originatingVASP":{"originatingVASP":{"legalPerson":{"name":{"nameIdentifier":[{"legalPersonName":"Notabene VASP SG","legalPersonNameIdentifierType":"LEGL"}]}}}}},"ivms101Encrypted":null,"on_behalf_of_myself":false,"originatorDid":"did:key:z6MkfZfFdd3suTaqUBTSNWDtrfdM7xicvZVi8yiZ9WZaqpZC","originatorProof":null,"originatorVASPdid":"did:ethr:0xd4bd902ec78578f33a20ff601504d2ab324cfab9","pii":{"beneficiaryVASP":{"beneficiaryVASP":{"legalPerson":{"name":{"nameIdentifier":[{"legalPersonName":"QmcbmuVehCtjLv5hQfoKqtxdP5svezpDMhbu5SQwhtvM9b","legalPersonNameIdentifierType":"QmYZd5EA2SdrScd11G435ZknfVDHVTKA3oaPDnQLBqt5VS"}]}}}},"originatingVASP":{"originatingVASP":{"legalPerson":{"name":{"nameIdentifier":[{"legalPersonName":"QmagFv5rU9CogwdgmRBBxbWoQ8GBHw6aZSwjKxWH4wYDdE","legalPersonNameIdentifierType":"QmTGE2RgEkVuswSnvee1REEvxRrySzF5uzh5hduyvHBMDw"}]}}}}},"pii_url":"https://pii.notabene.dev/","protocol":"TRLight","protocolData":{"trLightData":{"accessLinks":[],"notificationEmails":[]}},"showToBeneficiary":null,"status":"ACCEPTED","tracked_billing":false,"transactionAmount":"82700000","transactionAsset":"BTC","transactionBlockchainInfo":{"destination":"3WQ8RqWsdy1DPvWGRn9VKVcgnbUKkKg","origin":"1DbotH8QZ1NXD78R64vHvGp9YzHND5Ts","txHash":"4fdc2357-52af-490b-a7c2-22b159699bd7"},"transactionRef":"96b39bda-3617-4dea-93fd-8c10dc1a383a","transactionType":"TRAVELRULE","updatedAt":"2024-10-07T10:04:56.099Z","updatedBy":"did:ethr:0xfc929b9607b991980a49b84a0be28a698d863241"}},"version":"1.0.0"}
txHash and status
The txHash can be added to any of the travel rule statuses.
When txUpdate is called with the hash, you will get the a "duplicate" webhook push where everything is the same as before, except now it has a hash. The status does not change when adding it.
Webhook IPs
Make sure that your Webhook is reachable by Notabene (through SVIX). The requests to your webhook will come from one of the IPs mentioned here under EU.
Verify webhook payload
Please follow the guide here.
Updated about 1 month ago