---
title: "Verifica Fornitore (anti-frode pre-pagamento)"
method: POST
path: "/python/trust/verify-payee"
tags: ["Tool"]
---

# Verifica Fornitore (anti-frode pre-pagamento)

`POST /python/trust/verify-payee`

## Request

- Base URL: `https://imperioutils.com/api`
- URL: `https://imperioutils.com/api/python/trust/verify-payee`
- Auth: API key in header `X-API-Key`

Verifica anti-frode di un beneficiario PRIMA di pagare una fattura (contro la truffa del cambio-IBAN / Business Email Compromise). Controlli: IBAN (checksum MOD-97 + banca dal codice ABI), Partita IVA e Codice Fiscale (checksum), e — quando il servizio UE è raggiungibile — la ragione sociale reale via VIES live con match sul nome atteso. Restituisce un verdetto (ok / non_verificabile / attenzione / alto_rischio) + i red flag puntuali. `non_verificabile` = nessun segnale di frode MA nessuna fonte autorevole ha confermato chi sia il fornitore (P.IVA italiana non iscritta al VIES, o nessuna P.IVA fornita): non è un allarme, è il rifiuto di dire «ok» su un soggetto non identificato. A differenza degli altri strumenti fa I/O esterno (VIES): se VIES è giù o il budget di verifica è temporaneamente esaurito, il verdetto degrada ONESTAMENTE ad "attenzione" (mai un falso "ok"). NON sostituisce la verifica out-of-band (telefonata al fornitore su un numero già noto).

Costo: **0 crediti**. Autenticazione: header `X-API-Key` (una chiave gratuita si ottiene da https://imperioutils.com/signup e si rigenera da https://imperioutils.com/settings/profile).

La stessa operazione è provabile **senza account** su `POST /registry/demo/verifica-fornitore` con `action: "verify"`.

## Request body

- union
  - object
    - `iban` string, required: IBAN del beneficiario (es. IT60X0542811101000000123456).
    - `vat_number` string: Partita IVA con o senza prefisso paese (es. IT12345678901).
    - `codice_fiscale` string: Codice Fiscale (persona fisica / ditta individuale).
    - `expected_name` string: Ragione sociale attesa del fornitore, confrontata con quella ufficiale VIES.
    - `expected_country` string: Paese atteso del fornitore in ISO2 (default IT). Un IBAN estero è il campanello #1 della frode.
    - `ateco` string: Codice ATECO dichiarato del fornitore (solo cifre e punti, opzionale).
  - object
    - `iban` string: IBAN del beneficiario (es. IT60X0542811101000000123456).
    - `vat_number` string, required: Partita IVA con o senza prefisso paese (es. IT12345678901).
    - `codice_fiscale` string: Codice Fiscale (persona fisica / ditta individuale).
    - `expected_name` string: Ragione sociale attesa del fornitore, confrontata con quella ufficiale VIES.
    - `expected_country` string: Paese atteso del fornitore in ISO2 (default IT). Un IBAN estero è il campanello #1 della frode.
    - `ateco` string: Codice ATECO dichiarato del fornitore (solo cifre e punti, opzionale).
  - object
    - `iban` string: IBAN del beneficiario (es. IT60X0542811101000000123456).
    - `vat_number` string: Partita IVA con o senza prefisso paese (es. IT12345678901).
    - `codice_fiscale` string, required: Codice Fiscale (persona fisica / ditta individuale).
    - `expected_name` string: Ragione sociale attesa del fornitore, confrontata con quella ufficiale VIES.
    - `expected_country` string: Paese atteso del fornitore in ISO2 (default IT). Un IBAN estero è il campanello #1 della frode.
    - `ateco` string: Codice ATECO dichiarato del fornitore (solo cifre e punti, opzionale).

## Response `200`

Il JSON dello strumento, restituito così com'è.

## Other responses

- `401`: Nessuna credenziale o chiave rifiutata. Il corpo porta `details.header`, `details.docs` e `details.get_key`.
- `402`: Crediti esauriti.
- `429`: Tetto di richieste al minuto del piano superato.

---

[API](https://skmtc.dev/imperioutils/apis/imperio-utilities-api-fiscali-italiane.md) · [All operations](https://skmtc.dev/imperioutils/apis/imperio-utilities-api-fiscali-italiane/llms.txt) · [OpenAPI document](https://skmtc.dev/imperioutils/apis/imperio-utilities-api-fiscali-italiane/revisions/4b7a05d52f6c?raw)