> 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 Solução de Problemas de Integração

Comece pelo ambiente, carimbo de tempo e identificador de negócio da operação falhada. Uma verificação estruturada geralmente separa problemas de configuração de autenticação, rede e processamento assíncrono.

<h2 id="diagnostic-order">
  Ordem diagnóstica recomendada
</h2>

1. Confirme o ambiente afetado e a URL base.
2. Registre o intervalo de tempo UTC e a primeira solicitação que não tenha falhado.
3. Identifique o módulo: Trading Widget, Agent SDK, REST API, WebSocket, ou webhook.
4. Capturar o ID da solicitação, ID do usuário do parceiro, `agentOrderNo`, ID do pedido ou ID do evento do webhook.
5. Verifique códigos recentes, credenciais, listas brancas IP ou mudanças de implantação.
6. Reproduzir com o menor caso de teste seguro.

<h2 id="trading-widget-issues">
  Trading Widget questões
</h2>

| Sintoma                                       | Causa provável                                 | Corrigir                                                     |
| --------------------------------------------- | ---------------------------------------------- | ------------------------------------------------------------ |
| O iframe solicita o domínio local do parceiro | baseUrl está faltando                          | Passe baseUrl: '[https://app.6mm.com](https://app.6mm.com)'. |
| O iframe é invisível ou muito curto           | O recipiente principal não tem altura          | Defina a altura do recipiente ou a altura da passagem.       |
| token\_provider\_missing                      | O modo partner-token não possui provedor       | Adicionar autenticaçãotokenProvider.                         |
| auth\_exchange\_failed                        | Token embed inválido, expirado ou incompatível | Verifique a resposta do token backend e channelId.           |

<h2 id="agent-sdk-issues">
  Agent SDK questões
</h2>

| Sintoma                                 | Causa provável                                                                | Corrigir                                                                |
| --------------------------------------- | ----------------------------------------------------------------------------- | ----------------------------------------------------------------------- |
| Assinatura rejeitada                    | Segredo errado, desvio de clock ou campos de assinatura alterados manualmente | Deixe SDK gerar campos de assinatura e sincronizar o tempo do servidor. |
| Risco de movimento de fundos duplicados | Novo número de pedido usado após o tempo de espera                            | Consulte primeiro por agentOrderNo original.                            |
| PROCESSING tratado como fracasso        | Estado pendente mal interpretado                                              | Espere pelo webhook ou ligue para queryOrder.                           |
| Webhook processado várias vezes         | Comportamento de retentar sem idempotência                                    | Adicionar chaves de idempotência e verificações de estado final.        |

<h2 id="evidence-to-capture">
  Evidências a serem capturadas
</h2>

| Integração     | Evidências úteis                                                                                                                              |
| -------------- | --------------------------------------------------------------------------------------------------------------------------------------------- |
| Trading Widget | Página URL, caminho de SDK versão, console do navegador, requisições de rede falhadas, carga útil `onError` e dimensões do contêiner.         |
| Agent SDK      | SDK idioma/versão, URL base, UTC carimbo de data, ID de requisição, `agentOrderNo`, código de resposta e logs sanitizados.                    |
| Webhook        | Tempo de entrega, chave de evento ou negócio, resultado de validação de assinatura, estado de processamento e hash do corpo bruto sanitizado. |
| REST API       | Método, caminho, ambiente, ID de requisição, código de resposta e parâmetros sanitizados.                                                     |

Nunca inclua senhas, tokens de acesso, API segredos, assinaturas completas, chaves privadas ou dados pessoais não editados nos diagnósticos.

<h2 id="before-escalating">
  Antes de escalar
</h2>

* Retentar somente quando a operação estiver documentada como segura para tentar novamente.
* Após um timeout, consulte o identificador original do negócio em vez de criar um novo.
* Confirmar o clock do sistema e o ambiente de credenciais para erros de assinatura.
* Preservar a primeira falha e quaisquer resultados de tentativas posteriores.
* Use o [Modelo de Solicitação de Suporte](/pt-BR/resources/support-request-template) para enviar um relatório completo e redigido.

<h2 id="related-docs">
  Documentação relacionada
</h2>

#### [Trading Widget Início Rápido](/pt-BR/sdk/trading-widget/quick-start)

Verifique o carregamento do script, tamanho do container, configuração e callbacks.

#### [Segredos e Assinatura](/pt-BR/sdk/security/secrets-signing)

Verifique Agent SDK credenciais, relógios e campos assinados.

#### [Webhooks & Idempotência](/pt-BR/sdk/security/webhooks-idempotency)

Revise a verificação de retorno de chamada e o tratamento de eventos duplicados.