> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://docs.6mm.com/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://docs.6mm.com/_mcp/server.

# SDK Risoluzione dei problemi di integrazione

Inizia dall'ambiente, dall'ora e dall'identificatore aziendale per l'operazione fallita. Un controllo strutturato di solito separa i problemi di configurazione da quelli di autenticazione, di rete e di elaborazione asincrona.

<h2 id="diagnostic-order">
  Ordine diagnostico raccomandato
</h2>

1. Confermare l'ambiente e la URL di base interessati.
2. Registra l'intervallo di tempo UTC e la prima richiesta fallita.
3. Identifica il modulo: Trading Widget, Agent SDK, REST API, WebSocketo webhook.
4. Cattura l'ID richiesta, l'ID utente partner, `agentOrderNo`, l'ID ordine o l'ID evento webhook.
5. Controlla codice, credenziali, whitelist IP o modifiche al deployment.
6. Riprodurre con il caso di prova più piccolo e sicuro.

<h2 id="trading-widget-issues">
  Trading Widget problemi
</h2>

| Sintomo                                   | Causa probabile                                    | Fissaggio                                                    |
| ----------------------------------------- | -------------------------------------------------- | ------------------------------------------------------------ |
| iframe richiede il dominio locale partner | baseUrl manca                                      | Passo baseUrl: '[https://app.6mm.com](https://app.6mm.com)'. |
| iframe è invisibile o molto corto         | Il contenitore genitore non ha altezza             | Imposta l'altezza del contenitore o l'altezza del passaggio. |
| token\_provider\_missing                  | La modalità partner-token non ha un provider       | Aggiungi autenticazionetokenProvider.                        |
| auth\_exchange\_failed                    | Token embed invalido, scaduto o non corrispondente | Controlla la risposta del token backend e channelId.         |

<h2 id="agent-sdk-issues">
  Agent SDK problemi
</h2>

| Sintomo                                 | Causa probabile                                                           | Fissaggio                                                               |
| --------------------------------------- | ------------------------------------------------------------------------- | ----------------------------------------------------------------------- |
| Firma respinta                          | Segreto sbagliato, deriva di clock o cambiato manualmente i campi firmati | Lascia SDK generare campi di firma e sincronizzare il tempo del server. |
| Rischio di movimento di fondi duplicati | Nuovo numero d'ordine usato dopo il timeout                               | Prima invia la query per agentOrderNo originale.                        |
| PROCESSING trattato come fallimento     | Stato in attesa frainteso                                                 | Aspetta il webhook o chiama queryOrder.                                 |
| Webhook elaborato più volte             | Comportamento di riprova senza idempotenza                                | Aggiungi la chiave di idempotenza e i controlli di stato finale.        |

<h2 id="evidence-to-capture">
  Prove da catturare
</h2>

| Integrazione   | Prove utili                                                                                                                                      |
| -------------- | ------------------------------------------------------------------------------------------------------------------------------------------------ |
| Trading Widget | Pagina URL, percorso SDK versione, console browser, richieste di rete fallite, payload `onError` e dimensioni del container.                     |
| Agent SDK      | SDK lingua/versione, URL base, UTC timestamp, ID richiesta, `agentOrderNo`, codice di risposta e log sanificati.                                 |
| Webhook        | Tempo di consegna, chiave di evento o business, risultato di validazione della firma, stato di elaborazione e hash del corpo grezzo sanitizzato. |
| REST API       | Metodo, percorso, ambiente, ID richiesta, codice di risposta e parametri sanificati.                                                             |

Non includere mai password, token di accesso, API segreti, firme complete, chiavi private o dati personali non oscurati nelle diagnostiche.

<h2 id="before-escalating">
  Prima di degenerare
</h2>

* Ritentare solo quando l'operazione è documentata come sicura da riprovare.
* Dopo un timeout, interrogare l'identificativo originale dell'azienda invece di crearne uno nuovo.
* Confermare l'orologio di sistema e l'ambiente delle credenziali per errori di firma.
* Conservare il primo fallimento e eventuali risultati di ritenti successivi.
* Utilizzare il [Modello di Richiesta di Supporto](/it/resources/support-request-template) per inviare un report completo e oscurato.

<h2 id="related-docs">
  Documentazione correlata
</h2>

#### [Trading Widget Avvio rapido](/it/sdk/trading-widget/quick-start)

Verifica il caricamento degli script, la dimensione del container, la configurazione e i callback.

#### [Segreti e firma](/it/sdk/security/secrets-signing)

Controlla Agent SDK credenziali, orologi e campi firmati.

#### [Webhook e idempotenza](/it/sdk/security/webhooks-idempotency)

Rivedi la verifica del callback e la gestione degli eventi duplicati.