> 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

> Utilisez 6MM Agent SDK pour effectuer des appels API signés depuis des backends Java et PHP, associer les utilisateurs, transférer des actifs, générer des URL d’accès au trading, assurer l’idempotence et vérifier les webhooks.

Le 6MM Agent SDK concerne les services backend partenaires qui doivent appeler des agents privilégiés API sans mettre en œuvre la signature et la gestion des requêtes depuis zéro. Il ne doit pas s’exécuter en code navigateur, mobile ou bureau public car l’intégration utilise un partenaire API secret.

<h2 id="when-to-use-the-agent-sdk">
  Quand utiliser le Agent SDK
</h2>

Utilisez l’Agent SDK lorsque votre backend doit associer un utilisateur partenaire, transférer des actifs via un workflow approuvé, consulter les historiques de trading, créer une URL d’accès au trading intégré ou vérifier les notifications Webhook. Utilisez le [Trading Widget SDK](/fr/sdk/trading-widget/overview) séparément lorsque le frontend partenaire doit afficher l’interface de trading.

<h2 id="capabilities">
  Capacités
</h2>

| Scénario                   | Java SDK | PHP SDK |
| -------------------------- | -------- | ------- |
| Lier l’utilisateur         | Soutenu  | Soutenu |
| Transfert à montants fixes | Soutenu  | Soutenu |
| Transfert à tous           | Soutenu  | Soutenu |
| Transfert inverse          | Soutenu  | Soutenu |
| Ordres de requête          | Soutenu  | Soutenu |
| Créer une entrée URL       | Soutenu  | Soutenu |
| Vérification Webhook       | Soutenu  | Soutenu |

<h2 id="common-configuration">
  Configuration courante
</h2>

| Clé             | Exemple                                                                            | Description                                                |
| --------------- | ---------------------------------------------------------------------------------- | ---------------------------------------------------------- |
| baseUrl         | `https://agent-api.6mm.com`                                                        | 6MM Agent API service URL sans barrière de traînée.        |
| agentCode       | AGENT001                                                                           | Code d’agent associé.                                      |
| apiSecret       | your-api-secret                                                                    | API secret de signature stocké uniquement en arrière-plan. |
| defaultCurrency | USDT                                                                               | Monnaie par défaut pour les transferts et les API compte.  |
| webhookUrl      | [https://partner.example.com/6mm/webhook](https://partner.example.com/6mm/webhook) | Endpoint partenaire pour 6MM notifications webhook.        |

<h2 id="typical-integration-flow">
  Flux d’intégration typique
</h2>

1. Le frontend partenaire authentifie l’utilisateur via le système de compte propre au partenaire.
2. Le backend partenaire associe un identifiant stable côté partenaire.
3. Le backend appelle le Agent SDK avec `agentCode` et le API protégé secret.
4. Le SDK signe et envoie à l’agent API demande.
5. Le backend stocke l’identifiant métier retourné et traite les webhooks ultérieurs de manière idempotente.
6. Le frontend ne reçoit que le résultat éphémère ou l’accréditation d’entrée dont il a besoin.

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

| Pile backend | Commencez ici                                                                                                        |
| ------------ | -------------------------------------------------------------------------------------------------------------------- |
| Java         | [Java SDK Présentation](/fr/sdk/agent-sdk/java/overview) et [Java Départ rapide](/fr/sdk/agent-sdk/java/quick-start) |
| PHP          | [PHP SDK Présentation](/fr/sdk/agent-sdk/php/overview) et [PHP Départ rapide](/fr/sdk/agent-sdk/php/quick-start)     |

<h2 id="production-checklist">
  Liste de contrôle de la production
</h2>

* Charger `apiSecret` depuis un gestionnaire de secrets backend, pas le code source.
* Garder séparés les certifications de développement, de mise en scène et de production.
* Utiliser une cartographie utilisateur stable du partenaire et des identifiants uniques des ordres métier.
* Préserver l’identifiant original lors de la vérification du statut d’une requête en expiration.
* Vérifier les signatures webhook et stocker les identifiants d’événements traités.
* Expurger les secrets et signatures des journaux tout en conservant les identifiants de requête pour le support.

<h2 id="next-steps">
  Prochaines étapes
</h2>

#### [Java Départ rapide](/fr/sdk/agent-sdk/java/quick-start)

Installez et initialisez le Agent SDK dans un backend Java .

#### [PHP Départ rapide](/fr/sdk/agent-sdk/php/quick-start)

Installez et initialisez le Agent SDK dans un backend PHP .

#### [Webhooks et idempotence](/fr/sdk/security/webhooks-idempotency)

Vérifiez les rappels et évitez les traitements commerciaux en double.