> ## Documentation Index > Fetch the complete documentation index at: https://docs.didit.me/llms.txt > Use this file to discover all available pages before exploring further. # Annulla verifica del wallet di identità digitale > Annulla una verifica in sospeso del wallet di identità digitale standalone con Didit. Con questa API standalone puoi cancellare la verifica ancora in attesa. Chiama questo endpoint quando la persona abbandona una verifica del wallet in attesa nella tua applicazione. Autenticati con una chiave API appartenente all'applicazione che ha avviato la verifica. Leggi l'esito restituito invece di presumere che l'annullamento abbia avuto la meglio su un'autenticazione già completata. L'annullamento non serve a invertire una verifica dell'identità già completata. Consulta [Digital ID wallet APIs](https://docs.didit.me/it/standalone-apis/digital-id-wallets.md) per la sequenza di integrazione completa. ## OpenAPI ````yaml it/openapi-25.json POST /v3/id-verification/wallets/verifications/{request_id}/cancel/ openapi: 3.0.0 info: version: 3.0.0 title: Didit Verification API description: API di verifica dell'identità. Autenticati con l'intestazione x-api-key. servers: - url: https://verification.didit.me security: [] tags: [] paths: /v3/id-verification/wallets/verifications/{request_id}/cancel/: post: tags: - Digital ID wallets summary: Annulla una verifica del wallet description: >- Revoca una verifica in sospeso: viene rifiutata come annullata e mai fatturata. Una verifica già decisa viene restituita invariata. Smart-ID e Mobile-ID: una cancellazione che arriva mentre un polling sta verificando l'accesso attende alcuni secondi per tale polling, quindi la rifiuta, oppure la restituisce verificata se l'utente aveva già confermato. Una verifica che l'utente sta completando in questo momento non può essere annullata (409 verification_in_progress con Retry-After): riprova dopo tale numero di secondi per leggerne l'esito. operationId: cancel_wallet_verification parameters: - in: path name: request_id schema: type: string format: uuid description: Il request_id restituito dall'endpoint di avvio. required: true responses: '200': content: application/json: schema: $ref: >- #/components/schemas/DigitalIdWalletApiWalletVerificationResponse example: request_id: 00000000-0000-4000-8000-000000000001 wallet_verification: wallet: id: ftn name: Finnish Trust Network issuing_authority: Finnish banks and mobile operators (FTN) country: FIN status: Declined outcome: cancelled error: cancelled_by_customer interaction: redirect simulated: false expires_at: '2026-01-01T10:10:00Z' next_action: null identity: null attributes: null level_of_assurance: null verified_at: null signature_valid: null credential_type: person_identification vendor_data: your-customer-reference metadata: reference: example created_at: '2026-01-01T10:00:00Z' description: '' '403': content: application/json: schema: $ref: >- #/components/schemas/DigitalIdWalletApiClientCredentialsForbiddenErrorMessage description: 'Credenziali mancanti (x-api-key o Authorization: Bearer).' '404': content: application/json: schema: $ref: '#/components/schemas/DigitalIdWalletApiWalletVerificationError' description: >- errore not_found: nessuna verifica wallet di questa applicazione ha questo request_id. '409': content: application/json: schema: $ref: '#/components/schemas/DigitalIdWalletApiWalletVerificationError' description: >- errore verification_in_progress: l'utente sta completando questo accesso in questo momento. L'intestazione Retry-After indica quando riprovare; il nuovo tentativo restituisce la verifica decisa. security: - ApiKeyAuth: [] - BearerAuth: [] x-codeSamples: - lang: curl label: cURL source: |- curl --request POST \ --url https://verification.didit.me/v3/id-verification/wallets/verifications/REQUEST_ID/cancel/ \ --header 'x-api-key: YOUR_API_KEY' - lang: python label: Python source: |- from didit import Didit # Reads DIDIT_API_KEY. client = Didit() result = client.id_wallets.cancel_verification( "11111111-2222-3333-4444-555555555555", ) print(result) - lang: javascript label: Node.js source: >- import Didit from "@didit-protocol/sdk-node"; // Reads DIDIT_API_KEY. const didit = new Didit(); const result = await didit.idWallets.cancelVerification("11111111-2222-3333-4444-555555555555"); console.log(result); - lang: go label: Go source: "ctx := context.Background()\n// Reads DIDIT_API_KEY.\nclient := didit.NewClient()\n\nresult, err := client.IDWallets.CancelVerification(ctx, \"11111111-2222-3333-4444-555555555555\")\nif err != nil {\n\tlog.Fatal(err)\n}\nfmt.Printf(\"%+v\\n\", result)" - lang: java label: Java source: >- import me.didit.Didit; // Reads DIDIT_API_KEY. Didit client = new Didit(); var result = client.idWallets().cancelVerification("11111111-2222-3333-4444-555555555555"); System.out.println(result); - lang: php label: PHP source: >- idWallets->cancelVerification('11111111-2222-3333-4444-555555555555'); print_r($result->toArray()); - lang: ruby label: Ruby source: >- require "didit" # Reads DIDIT_API_KEY. didit = Didit::Client.new result = didit.id_wallets.cancel_verification("11111111-2222-3333-4444-555555555555") puts result.to_h - lang: csharp label: .NET source: >- using System; using System.Text.Json; using Didit; // Reads DIDIT_API_KEY. using var client = new DiditClient(); var result = await client.IdWallets.CancelVerificationAsync("11111111-2222-3333-4444-555555555555"); Console.WriteLine(JsonSerializer.Serialize(result)); components: schemas: DigitalIdWalletApiWalletVerificationResponse: type: object description: >- Una verifica del wallet autonoma, così come restituita da ciascun endpoint di wallet. properties: request_id: type: string format: uuid wallet_verification: $ref: '#/components/schemas/DigitalIdWalletApiWalletVerificationResult' vendor_data: type: string nullable: true metadata: type: object additionalProperties: {} nullable: true description: L'oggetto dei metadati inviato all'avvio, o null. created_at: type: string format: date-time required: - created_at - metadata - request_id - vendor_data - wallet_verification DigitalIdWalletApiClientCredentialsForbiddenErrorMessage: type: object properties: detail: type: string default: Forbidden - User doesn't have permission DigitalIdWalletApiWalletVerificationError: type: object properties: error: type: string description: Codice stabile leggibile da macchina, es. wallet_unavailable. detail: type: string required: - detail - error DigitalIdWalletApiWalletVerificationResult: type: object properties: wallet: allOf: - $ref: '#/components/schemas/DigitalIdWalletApiWallet' readOnly: true country: type: string status: type: string description: >- Non completato mentre è in sospeso, poi Approvata (verificata) o Rifiutata. outcome: $ref: >- #/components/schemas/DigitalIdWalletApiWalletVerificationResultOutcomeEnum error: type: string nullable: true readOnly: true interaction: allOf: - $ref: '#/components/schemas/DigitalIdWalletApiInteractionEnum' readOnly: true simulated: type: boolean readOnly: true expires_at: type: string format: date-time next_action: allOf: - $ref: '#/components/schemas/DigitalIdWalletApiWalletNextAction' nullable: true readOnly: true identity: allOf: - $ref: '#/components/schemas/DigitalIdWalletApiWalletIdentity' nullable: true readOnly: true attributes: type: object additionalProperties: {} nullable: true readOnly: true level_of_assurance: type: string nullable: true verified_at: type: string format: date-time nullable: true signature_valid: type: boolean nullable: true description: >- True dopo che la firma della credenziale è stata verificata; null per una simulata. credential_type: type: string nullable: true required: - attributes - country - credential_type - error - expires_at - identity - interaction - level_of_assurance - next_action - outcome - signature_valid - simulated - status - verified_at - wallet DigitalIdWalletApiWallet: type: object properties: id: type: string description: Id di catalogo del wallet, ad es. bankid_se. name: type: string issuing_authority: type: string nullable: true required: - id - issuing_authority - name DigitalIdWalletApiWalletVerificationResultOutcomeEnum: enum: - pending - verified - cancelled - timeout - failed type: string description: |- * `pending` - In sospeso * `verified` - Verificata * `cancelled` - Annullata dall'utente * `timeout` - Scaduta per timeout * `failed` - Non riuscita DigitalIdWalletApiInteractionEnum: enum: - redirect - in_app - digital_credentials type: string description: |- * `redirect` - redirect * `in_app` - in_app * `digital_credentials` - digital_credentials DigitalIdWalletApiWalletNextAction: type: object properties: type: allOf: - $ref: '#/components/schemas/DigitalIdWalletApiWalletNextActionTypeEnum' description: >- redirect: reindirizza il browser dell'utente a url. confirm_in_app: mostra verification_code all'utente, che verifica la corrispondenza con il codice nella propria app wallet e conferma lì; quindi esegui il polling. request_digital_credential: con un gesto dell'utente sull'origine da cui hai iniziato, richiedi al wallet con digital_credentials.request, quindi invia ciò che restituisce a POST .../verifications/{request_id}/response/. * `redirect` - redirect * `confirm_in_app` - confirm_in_app * `request_digital_credential` - request_digital_credential url: type: string format: uri description: 'Solo redirect: dove l''utente effettua l''accesso con il wallet.' digital_credentials: allOf: - $ref: >- #/components/schemas/DigitalIdWalletApiWalletDigitalCredentialsRequest description: >- Solo request_digital_credential: la richiesta da trasmettere al wallet. verification_code: type: string description: >- Solo confirm_in_app: il codice di confronto a 4 cifre mostrato anche dall'app del wallet. poll_interval_seconds: type: integer description: >- Solo confirm_in_app: la frequenza con cui chiamare POST .../verifications/{request_id}/poll/ per un feedback immediato. Didit esegue il polling degli accessi in sospeso anche in background, quindi il webhook segnala l'esito anche se non esegui il polling. required: - type DigitalIdWalletApiWalletIdentity: type: object properties: full_name: type: string nullable: true first_name: type: string nullable: true last_name: type: string nullable: true date_of_birth: type: string format: date nullable: true nationality: type: string nullable: true description: Nazionalità ISO3, solo quando dichiarata dal wallet (mai dedotta). issuing_state: type: string description: Paese ISO3 il cui schema ha emesso l'identità. required: - date_of_birth - first_name - full_name - issuing_state - last_name - nationality DigitalIdWalletApiWalletNextActionTypeEnum: enum: - redirect - confirm_in_app - request_digital_credential type: string description: |- * `redirect` - redirect * `confirm_in_app` - confirm_in_app * `request_digital_credential` - request_digital_credential DigitalIdWalletApiWalletDigitalCredentialsRequest: type: object properties: protocol: type: string description: openid4vp-v1-signed. request: type: object additionalProperties: {} description: >- Passalo così com'è: navigator.credentials.get({digital: request}) nel browser, oppure JSON.stringify(request) come requestJson di GetDigitalCredentialOption su Android. Firmato da Didit per la tua applicazione. required: - protocol - request securitySchemes: ApiKeyAuth: type: apiKey in: header name: x-api-key description: >- La chiave API della tua applicazione, da Developers -> API keys nella Business Console. La chiave primaria ha accesso completo. Una chiave con nome può avere un ambito definito: nessuno, lettura o scrittura per risorsa, limitata ad alcuni workflow o a sessioni approvate, a un elenco di indirizzi IP e a una data di scadenza. 401 indica che la chiave è errata, revocata o scaduta; 403 indica che non è stata inviata alcuna chiave, che la chiave non ha accesso a questa risorsa o azione, oppure che la richiesta proviene da un indirizzo non incluso nel suo elenco IP; 404 su una route di sessione indica che la sessione non rientra nei workflow o negli stati previsti dalla chiave. Una chiave senza accesso ai media riceve gli URL di immagini, video e PDF come null, e una chiave senza permessi di scrittura sulle sessioni riceve link e token di sessione come null. Consulta https://docs.didit.me/console/api-keys. BearerAuth: type: http scheme: bearer description: Il token di accesso client-credentials dell'applicazione. ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.