Segurança e Operações

SDK Solução de Problemas de Integração

Diagnostice Trading Widget, Agent SDK, assinatura, webhook, timeout e problemas de ambiente antes de escalar uma solicitação de suporte.

Ver como Markdown

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.

Ordem diagnóstica recomendada

  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.

Trading Widget questões

SintomaCausa provávelCorrigir
O iframe solicita o domínio local do parceirobaseUrl está faltandoPasse baseUrl: ‘https://app.6mm.com’.
O iframe é invisível ou muito curtoO recipiente principal não tem alturaDefina a altura do recipiente ou a altura da passagem.
token_provider_missingO modo partner-token não possui provedorAdicionar autenticaçãotokenProvider.
auth_exchange_failedToken embed inválido, expirado ou incompatívelVerifique a resposta do token backend e channelId.

Agent SDK questões

SintomaCausa provávelCorrigir
Assinatura rejeitadaSegredo errado, desvio de clock ou campos de assinatura alterados manualmenteDeixe SDK gerar campos de assinatura e sincronizar o tempo do servidor.
Risco de movimento de fundos duplicadosNovo número de pedido usado após o tempo de esperaConsulte primeiro por agentOrderNo original.
PROCESSING tratado como fracassoEstado pendente mal interpretadoEspere pelo webhook ou ligue para queryOrder.
Webhook processado várias vezesComportamento de retentar sem idempotênciaAdicionar chaves de idempotência e verificações de estado final.

Evidências a serem capturadas

IntegraçãoEvidências úteis
Trading WidgetPá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 SDKSDK idioma/versão, URL base, UTC carimbo de data, ID de requisição, agentOrderNo, código de resposta e logs sanitizados.
WebhookTempo de entrega, chave de evento ou negócio, resultado de validação de assinatura, estado de processamento e hash do corpo bruto sanitizado.
REST APIMé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.

Antes de escalar

  • 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 para enviar um relatório completo e redigido.
Trading Widget Início Rápido

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

Segredos e Assinatura

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

Webhooks & Idempotência

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