Segurança e Operações

SDK Resolução de Problemas de Integração

Diagnostica Trading Widget, Agent SDK, assinatura, webhook, timeout e problemas de ambiente antes de escalar um pedido de suporte.
Ver como Markdown

Comece pelo ambiente, carimbo temporal 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. Confirmar o ambiente afetado e a URL base.
  2. Registar o intervalo de tempo UTC e o primeiro pedido falhado.
  3. Identificar o módulo: Trading Widget, Agent SDK, REST API, WebSocket, ou webhook.
  4. Capturar o ID do pedido, ID do utilizador do parceiro, agentOrderNo, ID da encomenda ou ID do evento webhook.
  5. Verifique o código recente, credencial, IP whitelist ou alterações de implementação.
  6. Reproduzir com o menor caso de teste seguro.

Trading Widget questões

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

Agent SDK questões

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

Provas a capturar

IntegraçãoEvidências úteis
Trading WidgetPágina URL, SDK caminho de versão, consola do navegador, pedidos de rede falhados, carga útil onError e dimensões do contentor.
Agent SDKSDK linguagem/versão, URL base, carimbo temporal UTC , ID do pedido, agentOrderNo, código de resposta e registos 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 do pedido, código de resposta e parâmetros sanitizados.

Nunca inclua palavras-passe, tokens de acesso, API segredos, assinaturas completas, chaves privadas ou dados pessoais não censurados nos diagnósticos.

Antes de escalar

  • Tentar novamente apenas quando a operação estiver documentada como segura para tentar novamente.
  • Após um timeout, consultar o identificador original da empresa em vez de criar um novo.
  • Confirmar o relógio do sistema e o ambiente de credenciais para erros de assinatura.
  • Preservar o primeiro fracasso e quaisquer resultados de tentativas posteriores.
  • Utilizar o Modelo de Pedido de Suporte para enviar um relatório completo e censurado.
Trading Widget Início Rápido

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

Segredos e Assinatura

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

Webhooks & Idempotência

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