Bitpanda Custody can now include compliance data in the body of our webhooks.
How does it work?
Whenever a Bitcoin or Ethereum transaction reaches our platform, our system will run a KYT check on it. Our platform will flag its risk level (high risk, low risk, or unknown) and that information will be added to the property complianceInfo
in the webhook payload.
This new property will provide useful and real-time information about any potential risky funds on any incoming transactions. Users can utilize this information at their discretion and take actions like quarantining the funds until a thorough investigation is completed.
This is an example of what complianceInfo
would look like in the payload:
"complianceInfo": { "asset": "BTC", "transferReference": "b1141feb04e36090061961183a0e0137371b25dd4af1d41a66cab4e8023bd4c0:132rjmbFRDuyka9jJxrWNchhupBQjqJkB5", "status": "SUCCESS", "decision": "ALLOW", "data": { "riskRating": "UNKNOWN", "cluster": { "name": null, "category": null } } }
You can refer to our Webhook API documentation for full details.
Field Definition
Field Name | Description |
asset | BTC / ETH or an ERC20 token such as USDT, OMG... |
transferReference | transactionHash : address (the address receiving funds) |
status | SUCCESS indicates Bitpanda Custody successfully managed to query its KYT partner. |
decision | ALLOW / QUARANTINE. Bitpanda Custody will flag with a QUARANTINE warning any transactions that are high risk from one of the following categories:
|
riskRating | UNKNOWN / HIGH / LOW: Risk level associated with the transaction. Unknown risk means there is no known entity associated with the address. |
cluster | Addresses are added to clusters. This provides the general grouping of the sender of the transaction, e.g., "Exchange." |