FAQ

Frequently Asked Questions about integration.

What is the fastest way to integrate?

Start with Quickstart. For new KYT integrations, create a Client App, store the Client Secret on your backend, submit transactions to POST /kyt/transactions/ingest, and subscribe to webhooks.

Can I upload documents directly?

Hosted or embedded Flow sessions can upload artifacts through the public session upload endpoint when a valid session ID is available. Direct document management outside a Flow session is an operator/dashboard workflow unless your tenant has a specific integration contract enabled.

How do I trigger a specific Flow?

Flows are triggered by dashboard actions or by platform rules, such as a KYT transaction that requires step-up verification. Direct public Flow-session creation is not currently documented as a general client-credential API.

Can I approve a customer from a score alone?

No. A score is defensible only when composition, evidence, ruleset context, and audit trail are present. If the dashboard marks the result as partial, inconsistent, missing, or non-defensible, the case requires review or reconciliation before approval.

What does PEP review mean?

A PEP or restrictive-list match requires a compliance review. The analyst must confirm the match, mark it as false positive with justification, escalate it, or keep the case in review according to your policy.

Why did my transaction return accepted but no final decision?

KYT ingestion is asynchronous. A successful HTTP response means PredictaID received or deduplicated the transaction. Subscribe to webhooks for processing completion, alerts, and review states.

Should I store full CPF/CNPJ values in logs?

No. Mask CPF/CNPJ and personal identifiers in logs, screenshots, analytics, and support tools. Store only what is required for your legal basis and operational process.