Chainalysis Know Your Transaction (KYT) integration
With the Know Your Transactions (KYT) integration powered by Chainalysis, organizations can now streamline crypto monitoring and investigations directly within the Persona platform. Crypto transfers can be registered in Chainalysis, and alerts triggered in Chainalysis can automatically generate Cases in Persona.
This is useful for organizations who are looking to reduce tool switching and centralize their anti-money laundering (AML) workflows. By streamlining the end-to-end process within a single platform, teams can work more efficiently, reduce context switching, and accelerate investigations.
Related Workflow action steps
Chainalysis integrations available within Persona include the Address Screening Report and Know Your Transaction (KYT)-related workflow action steps. KYT-related workflow steps include:
- Register Transfer – Registers a cryptocurrency transfer in Chainalysis system to begin compliance monitoring
- Get Transfer Summary – Retrieves details of a registered transfer
- Get All Alerts – Retrieves all alerts information within your organization. By default, only transfer alerts will be returned
- Update An Alert’s Status – Updates the status of a specific alert and optionally adds a comment
Use of these steps require proper set up of Chainalysis credentials within the Persona marketplace. For directions on how to do this and all Chainalysis integrations with Persona, review the Chainalysis integration overview.
Know Your Transaction (KYT)
Example Case view focused on transaction monitoring
How to register a Transfer
Note: These steps require use of Transactions and a Workflow triggered on Transaction Created
.Transactions can be generated via API or created through a CSV Import.
Transaction Type
- Create a new transaction type (Note: an apt name may be Virtual Transactions) with the following schema:
- Note: While your schema can include other fields, these are the fields that are required to register a transaction within Chainalysis
Workflow
- Create a workflow with the following steps:
- Trigger workflow is
Transaction created
(filtered by the transaction type you just created) - Add the Register a Transfer in Chainalysis workflow step
- Map the transaction fields to the required Chainalysis fields for:
User ID
Asset
Network
Direction
Transfer Reference
- Trigger workflow is
2. Add a 10 second Wait Step
3. Add a step to Get a Transfer Summary from Chainalysis. Pass in the External ID created in the previous step
register_a_transfer_in_chainalysis.externalID
How to configure ongoing transaction monitoring
Note: These steps require the use of a similar Transaction Type outlined above in How to register a Transfer, a Case Template with a specific field schema, and a Workflow with a Recurring trigger.
Case Template
- Create a Case Template with the following minimum fields using the Cases Field Editor:
Workflow
- Set up an Recurring trigger for a Workflow:
- Schedule: Every Day
- Start Time: Choose a time that makes sense
- Object Type: Transaction
- Filter Criteria
- transaction_type (the transaction type you just created)
- id (pick a transaction ID. Note: this is important otherwise you’ll create a workflow run for every single transaction of the type you just created)
2. Add an Evaluate code step
- Add a custom code that calculates the current time - X hours so that it fetches all the transactions created in the last X hours
3. Add a Get All Alerts step
- Action: Get all alerts in Chainalysis
- Integration Credentials: Make sure your Chainalysis instance's specific API credentials are selected here
4. Add a Loop step
- Loop type: for each
- Loop through list: get_all_alerts.data
- Loop Mode: Sequential
5. Add a Create Case step within the loop
- Map the alert fields to the fields on the Case Template