Verificare lo stato AML

Recupera lo stato corrente e la valutazione del rischio di un controllo AML esistente. I dati vengono aggiornati quando sono disponibili nuove informazioni.

POST /v1/aml-checks/check

Richiesta

Parametri

Campo	Tipo	Obbligatorio	Descrizione
id	string	Sì	Identificativo del controllo AML

Bash

#!/bin/bash
API_TOKEN="your_api_token"
API_SECRET="your_api_secret"
REQUEST_BODY='{
  "id": "1042"
}'

# Calcola la firma
SIGNATURE=$(echo -n "${REQUEST_BODY}${API_SECRET}" | sha256sum | cut -d' ' -f1)

# Esegui la richiesta API
curl -X POST "https://api.trxup.com/v1/aml-checks/check" \
  -H "Authorization: Bearer ${API_TOKEN}" \
  -H "X-Signature: ${SIGNATURE}" \
  -H "Content-Type: application/json" \
  -d "${REQUEST_BODY}"

Node.js

const crypto = require('crypto');
const axios = require('axios');

const apiToken = 'your_api_token';
const apiSecret = 'your_api_secret';
const requestBody = JSON.stringify({
  id: '1042'
});

// Calcola la firma
const signature = crypto
  .createHash('sha256')
  .update(requestBody + apiSecret)
  .digest('hex');

// Esegui la richiesta API
axios({
  method: 'post',
  url: 'https://api.trxup.com/v1/aml-checks/check',
  headers: {
    'Authorization': `Bearer ${apiToken}`,
    'X-Signature': signature,
    'Content-Type': 'application/json'
  },
  data: requestBody
})
.then(response => console.log(response.data))
.catch(error => console.error(error));

PHP

<?php
$apiToken = 'your_api_token';
$apiSecret = 'your_api_secret';
$requestBody = json_encode([
  'id' => '1042'
]);

// Calcola la firma
$signature = hash('sha256', $requestBody . $apiSecret);

// Esegui la richiesta API
$ch = curl_init('https://api.trxup.com/v1/aml-checks/check');
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_POST, true);
curl_setopt($ch, CURLOPT_POSTFIELDS, $requestBody);
curl_setopt($ch, CURLOPT_HTTPHEADER, [
  'Authorization: Bearer ' . $apiToken,
  'X-Signature: ' . $signature,
  'Content-Type: application/json'
]);

$response = curl_exec($ch);
curl_close($ch);

echo $response;
?>

Python

import hashlib
import json
import requests

api_token = 'your_api_token'
api_secret = 'your_api_secret'
request_body = json.dumps({
  'id': '1042'
})

# Calcola la firma
signature = hashlib.sha256((request_body + api_secret).encode()).hexdigest()

# Esegui la richiesta API
headers = {
  'Authorization': f'Bearer {api_token}',
  'X-Signature': signature,
  'Content-Type': 'application/json'
}

response = requests.post(
  'https://api.trxup.com/v1/aml-checks/check',
  headers=headers,
  data=request_body
)

print(response.json())

Risposta

Restituisce i dettagli del controllo AML con i dati di rischio più aggiornati. Se il controllo è ancora pending, il server richiede di nuovo il risultato prima di rispondere, quindi ogni chiamata restituisce lo stato più recente; continua a interrogare finché lo stato non cambia.

Campi della risposta

Campo	Tipo	Descrizione
code	integer	Codice di risposta (0 = successo)
request_id	string	Identificatore univoco della richiesta
result	object	Dati del controllo AML
result.id	string	Identificativo del controllo AML
result.type	string	Tipo di servizio AML (address oppure hash)
result.address	string	Indirizzo analizzato
result.network	string	Codice della rete blockchain come scritto nell’elenco delle reti supportate (ad es. TRX, TetherOMNI)
result.status	string	Stato corrente (pending, processing, completed, failed, expired, skipped)
result.risk_score	string|null	Punteggio di rischio come stringa con due decimali (ad es. "12.50"), oppure null finché non è disponibile un punteggio
result.risk_level	string|null	Livello di rischio testuale (low, medium, high)
result.blacklist	boolean	Indica se è stata rilevata una corrispondenza in blacklist
result.risk_factors	array	Categorie di rischio a cui sono collegati i fondi, ordinate per score decrescente, una voce per categoria; [] vuoto se non è stata segnalata alcuna categoria (ad esempio finché il controllo non è completato)
result.risk_factors[].name	string	Chiave della categoria, una di quelle elencate in Categorie dei fattori di rischio; una categoria fuori da questo elenco viene segnalata come other
result.risk_factors[].label	string	Etichetta inglese della categoria (non tradotta)
result.risk_factors[].group	string	Gruppo di rischio della categoria: low, medium o high
result.risk_factors[].score	number	Quota dei fondi collegata a questa categoria, da 0 a 1, arrotondata a 3 decimali
result.checked_at	string	Timestamp di creazione del controllo (ISO 8601)
result.hash	string	Hash analizzato (solo per i controlli hash)
result.direction	string	Lato della transazione analizzato, deposit o withdrawal (solo per i controlli hash)

Categorie dei fattori di rischio

risk_factors[].name è sempre una di queste chiavi. Una categoria fuori da questo elenco viene segnalata come other. label è sempre in inglese: fa parte della risposta, non è una traduzione.

name	label	group
enforcement_action	Enforcement Action	high
ransom	Ransom	high
dark_market	Dark Market	high
dark_service	Dark Service	high
illegal_service	Illegal Service	high
mixer	Mixer	high
scam	Scam	high
gambling	Gambling	high
stolen_coins	Stolen Coins	high
exchange_fraudulent	Fraudulent Exchange	high
child_exploitation	Child Exploitation	high
sanctions	Sanctions	high
terrorism_financing	Terrorism Financing	high
malware	Malware	high
infrastructure_as_a_service	Infrastructure-as-a-Service	medium
decentralized_exchange_contract	Decentralized Exchange Contract	medium
unnamed_service	Unnamed Service	medium
atm	ATM	medium
risky_exchange	Risky Exchange	medium
p2p_exchange_mlrisk_high	P2P Exchange (High Risk)	medium
liquidity_pools	Liquidity Pools	medium
exchange	Exchange	low
merchant_services	Merchant Services	low
wallet	Wallet	low
miner	Miner	low
payment	Payment	low
marketplace	Marketplace	low
p2p_exchange	P2P Exchange	low
seized_assets	Seized Assets	low
other	Other	low

Esempio di risposta

{
  "code": 0,
  "request_id": "bbf74bcd-fb36-4df8-adc8-25f2bacd087b",
  "result": {
    "id": "1042",
    "type": "address",
    "address": "TPY1Kb8cKAZQfm95gXQQs2Mh8Uygtos21D",
    "network": "TRX",
    "status": "completed",
    "risk_score": "12.50",
    "risk_level": "medium",
    "blacklist": false,
    "risk_factors": [
      {
        "name": "exchange",
        "label": "Exchange",
        "group": "low",
        "score": 0.9
      },
      {
        "name": "p2p_exchange_mlrisk_high",
        "label": "P2P Exchange (High Risk)",
        "group": "medium",
        "score": 0.1
      }
    ],
    "checked_at": "2024-03-25T10:42:12+00:00"
  }
}

Per un controllo hash, hash e direction seguono checked_at:

{
  "code": 0,
  "request_id": "bbf74bcd-fb36-4df8-adc8-25f2bacd087b",
  "result": {
    "id": "1043",
    "type": "hash",
    "address": "TPY1Kb8cKAZQfm95gXQQs2Mh8Uygtos21D",
    "network": "TRX",
    "status": "completed",
    "risk_score": "3.20",
    "risk_level": "low",
    "blacklist": false,
    "risk_factors": [],
    "checked_at": "2024-03-25T10:44:31+00:00",
    "hash": "E3F2A1B66DBB9F0B24C4125229163944A7D91EB3F1AC5E409FFCEE0C81A913F2",
    "direction": "deposit"
  }
}

Possibili errori

Codice errore	Key	Descrizione
1	auth	Errore di autenticazione (token o firma non validi)
2	invalid_service_or_params	Parametri non validi (id mancante o vuoto)
30	aml_check_not_found	Controllo AML non trovato, oppure appartiene a un altro account
500	internal_server_error	Errore interno del server