Saltar al contingut principal
POST
curl

Per què no té estat

El cribratge de carteres autònom no escriu res a la taula de transaccions, de manera que no hi ha cap registre emmagatzemat del qual aquest endpoint pugui generar el document. En canvi, tornes a enviar el JSON exacte que ja t’ha retornat POST /v3/wallet-screening/, i Didit converteix aquest payload en un PDF sense tornar a cridar cap proveïdor.

El camp report_signature

Cada resposta de POST /v3/wallet-screening/ inclou ara un camp report_signature: una signatura opaca limitada a la teva aplicació. Aquest endpoint la verifica abans de generar el document, de manera que un client no pot editar risk_score, severity, sanctions_hit ni cap altre camp i obtenir un PDF amb la marca de Didit i un aspecte correcte per a un resultat que Didit mai no va produir. Reenvia sempre el cos complet de la resposta sense modificar, inclòs report_signature. Canviar l’ordre de les claus és correcte; canviar qualsevol valor signat no ho és.

Facturació

No es fa cap crida a un proveïdor i no es factura res: això només torna a generar un resultat que ja vas pagar quan vas cridar POST /v3/wallet-screening/.

Errors

Següents passos

Cribratge de carteres

Executa el cribratge de carteres subjacent sota demanda i obtén el resultat en JSON per reenviar aquí.

Cribratge de carteres sota demanda

Visió general de l’endpoint autònom de cribratge de carteres i del model de resultats.

Autoritzacions

x-api-key
string
header
requerit

La clau d'API de la teva aplicació, des de Developers -> API keys a la Business Console. La clau primària té accés complet. Una clau amb nom pot tenir l'abast limitat: cap, lectura o escriptura per recurs, limitada a determinats fluxos de treball o a sessions aprovades, a una llista d'adreces IP i a una data de caducitat. 401 significa que la clau és incorrecta, revocada o caducada; 403 significa que no s'ha enviat cap clau, que la clau no té accés a aquest recurs o acció, o que la sol·licitud prové d'una adreça fora de la seva llista d'IP; 404 en una ruta de sessió significa que la sessió està fora dels fluxos de treball o estats de la clau. Una clau sense accés a fitxers multimèdia rep els URL d'imatge, vídeo i PDF com a null, i una clau sense permís d'escriptura de sessions rep els enllaços de sessió i els tokens com a null. Consulta https://docs.didit.me/console/api-keys.

Cos

application/json

L'objecte JSON sense modificar retornat per POST /v3/wallet-screening/, incloent-hi report_signature.

La mateixa estructura que la resposta de POST /v3/wallet-screening/; passa aquest cos de resposta literalment, incloent-hi report_signature.

provider
string
requerit

Proveïdor que ha dut a terme el cribratge (p. ex. merklescience, crystal).

screening_type
enum<string>
requerit

Sempre WALLET_SCREENING per a aquest endpoint.

Opcions disponibles:
WALLET_SCREENING
risk_score
integer
requerit

Puntuació de risc normalitzada de 0 a 100. Un valor més alt indica una exposició més gran a entitats de risc. Merkle Science qualifica una adreça de 0 a 5, la qual cosa es correspon amb 0, 15, 35, 55, 75 o 95.

severity
enum<string>
requerit

Grup de risc derivat de risk_score: 0-9 UNKNOWN, 10-39 LOW, 40-69 MEDIUM, 70-89 HIGH, 90-100 CRITICAL. UNKNOWN és la franja més baixa, no un estat independent sense dades: un risk_score de 0 (el cas habitual d'una adreça neta) significa sense avaluació adversa, mentre que una puntuació diferent de zero en l'interval 1-9 és un senyal real però inferior a LOW; llegeix el risk_score, no només la franja. No tractis mai UNKNOWN com una qualificació afirmativa de risc baix o neta; no la mostris com un aprovat.

Opcions disponibles:
UNKNOWN,
LOW,
MEDIUM,
HIGH,
CRITICAL
status
enum<string>
requerit

Estat del resultat del cribratge.

Opcions disponibles:
SCREENED,
PENDING,
ERROR
summary
string
requerit

Resum del resultat del cribratge, llegible per a humans.

wallet_address
string
requerit

L'adreça analitzada, que es retorna tal qual.

blockchain
string
requerit

La blockchain que s'ha analitzat.

source_of_funds
object[]
requerit

D'on ha rebut fons l'adreça, atribuït per entitat. Cada entrada és un desglossament de l'exposició.

destination_of_funds
object[]
requerit

Cap a on ha enviat fons l'adreça, atribuït per entitat. Té la mateixa estructura d'element que source_of_funds amb exposure_direction = outgoing.

counterparty_connections
object[]
requerit

Entitats a les quals el proveïdor atribueix l'adreça analitzada. En el cas de Merkle Science, provenen de les etiquetes de propietari i d'usuari de la mateixa adreça, de manera que la mateixa entitat pot aparèixer dues vegades, i no comporten fluxos de fons: received_usd, sent_usd, received_hops i sent_hops són null i percentage és 0. No facis encaminament segons risk_level o is_direct aquí: fes servir sanctions_hit, dominant_risk_category i risk_factors[].is_high_risk per al veredicte, i exposure_type a source_of_funds/destination_of_funds per determinar si són directes.

sanctions_hit
boolean
requerit

Cert si l'adreça té exposició directa o indirecta a sancions.

dominant_risk_category
string | null
requerit

Categoria d'alt risc amb més pes, o null quan cap no és dominant (p. ex. sanctioned, mixer, stolen_funds).

report_signature
string
requerit

Signatura HMAC-SHA256 opaca sobre aquest resultat exacte, delimitada a la teva aplicació. No té sentit per si sola: torna a enviar el cos complet de la resposta, sense modificar i incloent aquest camp, a POST /v3/wallet-screening/pdf/ per renderitzar-lo com a PDF. L'endpoint de PDF rebutja la sol·licitud amb 400 si falta report_signature o si s'ha editat algun camp signat (p. ex., risk_score, severity, sanctions_hit) abans de tornar-lo a enviar.

transaction_hash
string | null

Camp de cribratge de transaccions, compartit amb l'estructura del resultat. Sempre és null en un resultat de cribratge de carteres.

block_timestamp
string | null

Camp de cribratge de transaccions, compartit amb l'estructura del resultat. Sempre és null en un resultat de cribratge de carteres.

total_value_usd
number | null

Camp de cribratge de transaccions, compartit amb l'estructura del resultat. Sempre és null en un resultat de cribratge de carteres.

fee_usd
number | null

Camp de cribratge de transaccions, compartit amb l'estructura del resultat. Sempre és null en un resultat de cribratge de carteres.

sender_rows
object[]

Camp de cribratge de transaccions, compartit amb l'estructura del resultat. Sempre està buit en un resultat de cribratge de carteres.

receiver_rows
object[]

Camp de cribratge de transaccions, compartit amb l'estructura del resultat. Sempre està buit en un resultat de cribratge de carteres.

transaction_flows
object[]

Camp de cribratge de transaccions, compartit amb l'estructura del resultat. Sempre està buit en un resultat de cribratge de carteres.

transaction_flows_status
string | null

Camp de cribratge de transaccions, compartit amb l'estructura del resultat. Sempre és null en un resultat de cribratge de carteres.

transaction_flows_error
string | null

Camp de cribratge de transaccions, compartit amb l'estructura del resultat. Sempre és null en un resultat de cribratge de carteres.

network_nodes
object[]

Nodes del graf d'exposició per al cribratge de transaccions. Buit en un resultat de cribratge de carteres.

network_edges
object[]

Arestes del graf d'exposició per al cribratge de transaccions. Buit en un resultat de cribratge de carteres.

pep_counterparty
boolean | null

Exposició com a persona políticament exposada. null quan no hi ha cap detecció de PEP disponible, que és el cas de tots els resultats actualment perquè cap proveïdor n'informa; false només per a un resultat de cribratge explícitament negatiu. No interpretis null com una comprovació de PEP completada.

risk_factors
object[]

Explicació classificada de risk_score: què ha produït aquest veredicte. Els proveïdors avaluen una adreça segons el seu propi model i només retornen un veredicte (Merkle Science retorna un enter del 0 al 5), de manera que la puntuació per si sola no permet prendre decisions. S'ordena primer per risc alt i després pel valor que ha passat per cada factor determinant, limitat als cinc més rellevants; source_of_funds i destination_of_funds sempre inclouen el desglossament complet. Un risk_score alt sense cap entrada is_high_risk significa que el proveïdor no ha detectat coincidències amb sancions ni entitats atribuïdes i ha avaluat l'adreça purament segons el seu propi model d'exposició; summary ho indica explícitament.

raw_response
object

El payload propi del proveïdor. La seva estructura és específica del proveïdor i pot canviar sense previ avís: llegeix els camps normalitzats en lloc d'analitzar-lo directament.

Resposta

El document PDF renderitzat, retornat directament com a binari application/pdf: no hi ha cap contenidor JSON.

The response is of type file.

Darrera modificació el 7 de novembre del 2026