Webhook payload examples
Inspect transaction snapshots and route wallet verification updates.
Webhook requests contain JSON snapshots, with the event family in X-Event-Type. Verify the signature over the raw body before parsing it. Use the record id for reconciliation and retrieve the latest API representation before making an irreversible decision.
Transaction snapshots
X-Event-Type: transaction covers incoming records and outgoing delivery, response, or data updates. Use direction to select your workflow. Notifications include the current transaction representation, not only changed fields.
Inspect status, statusReasoning, blockchainInfo, parties and VASP information, and available riskScore, warnings, and ruleEngine results. Optional fields can be null or omitted. The Travel Rule data model is the shared field reference for create responses, detail reads, and notifications.
Incoming message example
This example shows an incoming record after destination-wallet confirmation. Until confirmation, participant PII may be redacted; see wallet confirmation and PII.
{
"id": "233e3fd4-2ef0-677c-a398-8f993d131a19",
"status": "DELIVERED",
"statusReasoning": null,
"direction": "INCOMING",
"createdAt": "2025-12-09T12:55:30.519Z",
"asset": "ETH",
"amount": 0.059625001,
"blockchainInfo": {
"transactionHash": "0x8129df36bf862c55702ab3991c4cc6d00903dc7af4b6f1afc909c216f07e34bd",
"origin": "0x1234567890abcdef1234567890abcdef12345678",
"destination": "0xabcdef1234567890abcdef1234567890abcdef12",
"destinationType": "CUSTODIAL",
"blockchain": "Ethereum",
"isDestinationConfirmed": true,
"destinationWalletId": 7069
},
"vaspInfo": {
"originatorVaspName": "CryptoXYZ",
"originatorVaspEmail": "support@xyz.domain",
"beneficiaryVaspName": "CryptoXchange",
"beneficiaryVaspEmail": "support@cryptox.domain",
"beneficiaryVaspExtraInfo": null
},
"originator": {
"type": "NATURAL",
"name": "Diana DueDiligence",
"accountNumber": "originator-account-123",
"address": "873 Audit Alley",
"country": "AU",
"nationalIdentificatorType": null,
"nationalIdentificator": null,
"customerNumber": null,
"dateOfBirth": null,
"placeOfBirth": null
},
"beneficiary": {
"type": "NATURAL",
"name": "John Smither",
"accountNumber": "AC-123",
"country": null,
"nationalIdentificatorType": null,
"nationalIdentificator": null
},
"travelRuleMessageSource": "CryptoSwift",
"warnings": [],
"riskScore": {
"originatorRiskScore": 72,
"originatorRiskSeverity": "high",
"beneficiaryRiskScore": 8,
"beneficiaryRiskSeverity": "low"
},
"ruleEngine": {
"decision": "REVIEW",
"ruleEngineId": "6292e827-ce05-4cae-a3c8-43e1fb073e1e",
"ruleId": "7f3db7f7-b5b4-4dd7-8de6-e6c15a6eb9e2",
"ruleName": "Review high-risk incoming originator",
"conditions": {
"all": [
{
"field": "riskSeverity",
"value": "high",
"operator": "EQ"
}
],
"any": []
},
"ruleEngineVersion": 3,
"scope": "INCOMING",
"waitForSeconds": null,
"onTimeoutDecision": null
},
"identifiedTenant": {
"name": "CryptoXchange",
"email": "support@cryptox.domain"
}
}
Outgoing status update example
{
"id": "233e3fd4-2ef0-477c-a398-8f993d131a19",
"status": "CONFIRMED",
"statusReasoning": null,
"direction": "OUTGOING",
"createdAt": "2026-07-31T09:42:18.519Z",
"asset": "ETH",
"amount": 0.059625001,
"amountUsd": 223.41,
"amountEur": 193.64,
"metadata": "withdrawal-8472",
"blockchainInfo": {
"transactionHash": "0x8129df36bf862c55702ab3991c4cc6d00903dc7af4b6f1afc909c216f07e34bd",
"origin": "0x1234567890abcdef1234567890abcdef12345678",
"destination": "0xabcdef1234567890abcdef1234567890abcdef12",
"destinationType": "CUSTODIAL",
"blockchain": "Ethereum",
"isDestinationConfirmed": true,
"destinationWalletId": 7069
},
"vaspInfo": {
"originatorVaspName": "Originator VASP",
"originatorVaspEmail": "support@originator.example",
"beneficiaryVaspName": "Beneficiary VASP",
"beneficiaryVaspEmail": "support@beneficiary.example",
"beneficiaryVaspExtraInfo": null
},
"originator": {
"type": "NATURAL",
"name": "Diana DueDiligence",
"accountNumber": "customer-123",
"address": "873 Audit Alley",
"country": "AU",
"nationalIdentificatorType": null,
"nationalIdentificator": null,
"customerNumber": "customer-123",
"dateOfBirth": null,
"placeOfBirth": null
},
"beneficiary": {
"type": "NATURAL",
"name": "John Smither",
"accountNumber": "AC-123",
"country": "EE",
"nationalIdentificatorType": null,
"nationalIdentificator": null
},
"travelRuleMessageSource": "CryptoSwift",
"riskScore": {
"originatorRiskScore": 18,
"originatorRiskSeverity": "low",
"beneficiaryRiskScore": 12,
"beneficiaryRiskSeverity": "low",
"sanctions": {
"originatorWallet": {
"isSanctioned": false,
"details": []
},
"beneficiaryWallet": {
"isSanctioned": false,
"details": []
}
}
},
"ruleEngine": {
"decision": "PROCEED",
"ruleEngineId": "6292e827-ce05-4cae-a3c8-43e1fb073e1e",
"ruleId": "7f3db7f7-b5b4-4dd7-8de6-e6c15a6eb9e2",
"ruleName": "Proceed with low-risk outgoing transfer",
"conditions": {
"all": [
{
"field": "riskSeverity",
"operator": "EQ",
"value": "low"
}
],
"any": []
},
"ruleEngineVersion": 3,
"scope": "OUTGOING",
"waitForSeconds": null,
"onTimeoutDecision": null
}
}
Wallet verification snapshots
X-Event-Type: wallet-verification covers ownership proof, asynchronous Satoshi Test results, additional evidence submissions, and reviewer updates. Use the verification ID and read the latest verification before proceeding.
Wallet ownership and additional steps have separate statuses. Do not treat every notification or top-level VERIFIED result as completion of every requested check. See the wallet verification payload example and additional-step lifecycles.