Run a KYT Check

This guide explains how to access the risk data.

When a payment is detected,we run a check and if the transaction fails KYT checks a payment.failed webhook is sent to your endpoint.

Example KYT check result:

{
  "payment_id": "pay_abc123",
  "risk_level": "high",
  "score": 70,
  "flags": ["OFAC List"]
}

If the transaction is blocked due to risk:

{
  "event": "payment.failed",
  "reason": "Risk blocked"
}

No need to poll — you’ll always be alerted.

You can also fetch the latest KYT result at any time or run one one on a transaction:

GET /rsik/transaction/:payment_id

{
  "risk_level": "medium",
  "score": 54,
  "flags": ["High-volume address"]
}

Endpoint	Description
`GET /risk/history`	View all KYT checks for your merchants
`GET /risk/summary/merchant/:merchant_id`	Aggregated risk score for a specific merchant
`GET /risk/summary/total`	Total KYT exposure across your PSP account