> 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

> Utiliza 6MM Agent SDK para realizar llamadas API firmadas desde backends en Java y PHP, vincular usuarios, transferir activos, generar URL de acceso al trading, garantizar la idempotencia y verificar webhooks.

La 6MM Agent SDK es para servicios de backend asociados que necesitan llamar a API de agente privilegiado sin implementar la gestión de firmas y solicitudes desde cero. No debe ejecutarse en código de navegador, móvil o escritorio público porque la integración utiliza un socio API secreto.

<h2 id="when-to-use-the-agent-sdk">
  ¿Cuándo usar el Agent SDK
</h2>

Utiliza el Agent SDK cuando tu backend necesite vincular a un usuario socio, transferir activos mediante un flujo aprobado, consultar registros de trading, crear una URL de acceso al trading integrado o verificar notificaciones de Webhook. Utiliza el [Trading Widget SDK](/es-ES/sdk/trading-widget/overview) por separado cuando el frontend del socio necesite mostrar la interfaz de trading.

<h2 id="capabilities">
  Capacidades
</h2>

| Escenario                      | Java SDK | PHP SDK |
| ------------------------------ | -------- | ------- |
| Vincular usuario               | Apoyado  | Apoyado |
| Transferencia de cantidad fija | Apoyado  | Apoyado |
| Transfiere todo                | Apoyado  | Apoyado |
| Transferencia inversa          | Apoyado  | Apoyado |
| Órdenes de consulta            | Apoyado  | Apoyado |
| Crear URL                      | Apoyado  | Apoyado |
| Verificación de Webhook        | Apoyado  | Apoyado |

<h2 id="common-configuration">
  Configuración común
</h2>

| Clave           | Ejemplo                                                                            | Descripción                                                |
| --------------- | ---------------------------------------------------------------------------------- | ---------------------------------------------------------- |
| baseUrl         | `https://agent-api.6mm.com`                                                        | 6MM Agent API servicio URL sin barra lateral.              |
| agentCode       | AGENT001                                                                           | Código de agente asociado.                                 |
| apiSecret       | tu-api-secreto                                                                     | API secreto de firma almacenado solo en el backend.        |
| defaultCurrency | USDT                                                                               | Moneda predeterminada para transferencias y API de cuenta. |
| webhookUrl      | [https://partner.example.com/6mm/webhook](https://partner.example.com/6mm/webhook) | Endpoint de socios para notificaciones de 6MM webhook.     |

<h2 id="typical-integration-flow">
  Flujo típico de integración
</h2>

1. El frontend del socio autentica al usuario a través del propio sistema de cuenta del socio.
2. El backend del socio asigna al usuario a un identificador estable del lado del socio.
3. El backend llama al Agent SDK con `agentCode` y el API protegido secreto.
4. El SDK firma y envía la solicitud API Agente.
5. El backend almacena el identificador de negocio retornado y procesa los webhooks posteriores de manera idempotente.
6. El frontend solo recibe el resultado efímero o la credencial de entrada que necesita.

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

| Pila de backend | Empieza aquí                                                                                                         |
| --------------- | -------------------------------------------------------------------------------------------------------------------- |
| Java            | [Java SDK Resumen](/es-ES/sdk/agent-sdk/java/overview) y [Java Inicio rápido](/es-ES/sdk/agent-sdk/java/quick-start) |
| PHP             | [PHP SDK Resumen](/es-ES/sdk/agent-sdk/php/overview) y [PHP Inicio rápido](/es-ES/sdk/agent-sdk/php/quick-start)     |

<h2 id="production-checklist">
  Lista de verificación de producción
</h2>

* Cargar `apiSecret` desde un gestor de secretos backend, no desde el código fuente.
* Mantener separadas las credenciales de desarrollo, puesta en escena y producción.
* Utilizar un mapeo de usuario de socios estables e identificadores únicos de órdenes de negocio.
* Conservar el identificador original al comprobar el estado de una solicitud con tiempo de espera.
* Verificar firmas de webhook y almacenar los IDs de eventos procesados.
* Redactar secretos y firmas de los registros mientras se conservan los IDs de solicitud para el soporte.

<h2 id="next-steps">
  Próximos pasos
</h2>

#### [Java Inicio rápido](/es-ES/sdk/agent-sdk/java/quick-start)

Instala e inicializa el Agent SDK en un backend Java .

#### [PHP Inicio rápido](/es-ES/sdk/agent-sdk/php/quick-start)

Instala e inicializa el Agent SDK en un backend PHP .

#### [Webhooks e idempotencia](/es-ES/sdk/security/webhooks-idempotency)

Verifica las devoluciones de llamada y evita el procesamiento empresarial duplicado.