> 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.

# 6MM Agent SDK

> Usa 6MM Agent SDK per effettuare chiamate API firmate da backend Java e PHP, associare gli utenti, trasferire asset, generare URL di accesso al trading, gestire l’idempotenza e verificare i webhook.

Il 6MM Agent SDK riguarda i servizi backend partner che devono chiamare un Agent API privilegiato senza implementare la gestione della firma e delle richieste da zero. Non deve funzionare in codice browser, mobile o desktop pubblico perché l'integrazione utilizza un partner API segreto.

<h2 id="when-to-use-the-agent-sdk">
  Quando usare il Agent SDK
</h2>

Usa l’Agent SDK quando il backend deve associare un utente partner, trasferire asset tramite un flusso approvato, consultare i registri di trading, creare un URL di accesso al trading integrato o verificare le notifiche Webhook. Usa separatamente il [Trading Widget SDK](/it/sdk/trading-widget/overview) quando il frontend del partner deve mostrare l’interfaccia di trading.

<h2 id="capabilities">
  Capacità
</h2>

| Scenario                      | Java SDK   | PHP SDK    |
| ----------------------------- | ---------- | ---------- |
| Associare l'utente            | Supportati | Supportati |
| Trasferimento a importo fisso | Supportati | Supportati |
| Trasferisci tutto fuori       | Supportati | Supportati |
| Trasferimento inverso         | Supportati | Supportati |
| Ordini di query               | Supportati | Supportati |
| Crea URL                      | Supportati | Supportati |
| Verifica Webhook              | Supportati | Supportati |

<h2 id="common-configuration">
  Configurazione comune
</h2>

| Chiave          | Esempio                                                                            | Descrizione                                           |
| --------------- | ---------------------------------------------------------------------------------- | ----------------------------------------------------- |
| baseUrl         | `https://agent-api.6mm.com`                                                        | 6MM Agent API servizio URL senza slash di seguimento. |
| agentCode       | AGENT001                                                                           | Codice agente partner.                                |
| apiSecret       | your-api-secret                                                                    | API segreto di firma memorizzato solo nel backend.    |
| defaultCurrency | USDT                                                                               | Valuta predefinita per trasferimenti e API conto.     |
| webhookUrl      | [https://partner.example.com/6mm/webhook](https://partner.example.com/6mm/webhook) | Partner endpoint per notifiche 6MM webhook.           |

<h2 id="typical-integration-flow">
  Flusso tipico di integrazione
</h2>

1. Il frontend del partner autentica l'utente tramite il sistema account del partner.
2. Il backend partner mappa l'utente a un identificatore stabile lato partner.
3. Il backend chiama il Agent SDK con `agentCode` e il API protetto segreto.
4. Il SDK firma e invia l'Agente API richiesta.
5. Il backend memorizza l'identificativo di business restituito e processa ipotentemente i webhook successivi.
6. Il frontend riceve solo il risultato di breve durata o la credenziali di ingresso necessaria.

<h2 id="choose-an-sdk">
  Scegli un SDK
</h2>

| Stack backend | Inizia da qui                                                                                                    |
| ------------- | ---------------------------------------------------------------------------------------------------------------- |
| Java          | [Java SDK Panoramica](/it/sdk/agent-sdk/java/overview) e [Java Avvio rapido](/it/sdk/agent-sdk/java/quick-start) |
| PHP           | [PHP SDK Panoramica](/it/sdk/agent-sdk/php/overview) e [PHP Avvio rapido](/it/sdk/agent-sdk/php/quick-start)     |

<h2 id="production-checklist">
  Elenco di controllo della produzione
</h2>

* Carica `apiSecret` da un gestore di segreti backend, non dal codice sorgente.
* Mantenere separati le credenziali di sviluppo, staging e produzione.
* Utilizzare una mappatura utente partner stabile e identificatori unici.
* Preservare l'identificatore originale quando si verifica lo stato di una richiesta con timeout.
* Verifica le firme dei webhook e memorizza gli ID degli eventi processati.
* Oscurare segreti e firme dai log mantenendo gli ID delle richieste per il supporto.

<h2 id="next-steps">
  Passi successivi
</h2>

#### [Java Avvio rapido](/it/sdk/agent-sdk/java/quick-start)

Installa e inizializza il Agent SDK in un backend Java .

#### [PHP Avvio rapido](/it/sdk/agent-sdk/php/quick-start)

Installa e inizializza il Agent SDK in un backend PHP .

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

Verifica i callback e evita l'elaborazione duplicata del business.