SDK Solução de problemas de integração

Comece com o ambiente, o carimbo de data/hora e o identificador comercial da operação com falha. Uma verificação estruturada geralmente separa problemas de configuração de problemas de autenticação, rede e processamento assíncrono.

Ordem de diagnóstico recomendada

Confirme o ambiente afetado e a base URL.
Registre o intervalo de tempo UTC e a primeira solicitação com falha.
Identifique o módulo: Trading Widget, Agent SDK, REST API, WebSocket ou webhook.
Capture o ID da solicitação, o ID do usuário parceiro, agentOrderNo, o ID do pedido ou o ID do evento webhook.
Verifique código recente, credencial, lista de permissões IP ou alterações de implantação.
Reproduza com o menor caso de teste seguro.

Sintoma	Causa provável	Consertar
iframe solicita domínio local do parceiro	baseUrl está faltando	Passe baseUrl: ‘https://app.6mm.com’.
iframe é invisível ou muito curto	O contêiner pai não tem altura	Defina a altura do recipiente ou a altura da passagem.
token_provider_missing	modo de token de parceiro não tem provedor	Adicionar autenticação.tokenProvider.
auth_exchange_failed	Token incorporado inválido, expirado ou incompatível	Verifique a resposta do token de backend e channelId.

Agent SDK problemas

Sintoma	Causa provável	Consertar
Assinatura rejeitada	Segredo errado, desvio de relógio ou campos assinados alterados manualmente	Deixe SDK gerar campos de assinatura e sincronizar o horário do servidor.
Risco de movimentação de fundos duplicados	Novo número de pedido usado após o tempo limite	Consulte primeiro pelo agentOrderNo original.
PROCESSING tratado como falha	Estado pendente mal compreendido	Aguarde webhook ou ligue para queryOrder.
Webhook processado várias vezes	Tentar novamente o comportamento sem idempotência	Adicione chave de idempotência e verificações de estado final.

Evidências para capturar

Integração	Evidência útil
Trading Widget	Página URL, caminho da versão SDK, console do navegador, solicitações de rede com falha, carga útil `onError` e dimensões do contêiner.
Agent SDK	SDK idioma/versão, base URL, UTC carimbo de data/hora, ID da solicitação, `agentOrderNo`, código de resposta e logs limpos.
Webhook	Prazo de entrega, evento ou chave de negócios, resultado da validação de assinatura, estado de processamento e hash de corpo bruto higienizado.
REST API	Método, caminho, ambiente, ID de solicitação, código de resposta e parâmetros higienizados.

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

Antes de escalar

Tente novamente somente quando a operação estiver documentada como segura para tentar novamente.
Após um tempo limite, consulte o identificador comercial original em vez de criar um novo.
Confirme o relógio do sistema e o ambiente de credenciais para erros de assinatura.
Preserve a primeira falha e quaisquer resultados de novas tentativas posteriores.
Use o Modelo de solicitação de suporte para enviar um relatório completo e redigido.

Documentos relacionados

Trading Widget Início rápido

Verifique o carregamento do script, o tamanho do contêiner, a configuração e os retornos de chamada.

Segredos e assinatura

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

Webhooks e idempotência

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

Diagnóstico Java v0.3.0

Sintoma	Verificação e recuperação
A solicitação de financiamento tem um resultado desconhecido	Mantenha o original `agentOrderNo`; chame `queryWalletTransfer` com o ambiente original. Não use `queryOrder`.
UI de simulação mostra fundos inesperados	Verifique o frontend `tradingMode` separadamente do backend `environment`; a conta `isSimulatedUser` não encaminha solicitações.
Erro de consulta `6905`	Recue usando a cota de parceiro compartilhado, tente novamente o mesmo cursor e filtre por SDK.
Erro de consulta `6904`	Reduza consultas simultâneas e restrinja a janela de tempo; entre em contato com o suporte se persistir.
Cursor inválido ou expirado	Reinicie a mesma janela de histórico fixa e desduplicar os registros salvos.
Novo método Java ausente	Verifique o artefato Maven resolvido em relação à tag pública `v0.3.0`; remova dependências conflitantes de acordo com sua política de artefatos.

Referência de consulta e erro · Guia de atualização

Webhook problemas de recebimento

Sintoma	Verificação e manuseio
Nenhuma nova tentativa após retornar a falha JSON	Verifique se o endpoint ainda retorna HTTP 200. A entrega usa apenas o status HTTP, não um indicador de sucesso no corpo.
As novas tentativas continuam após 401 ou 409	As respostas diferentes de 2xx seguem a política de repetição existente; investigue assinaturas, conteúdo de notificação ou configuração do comerciante.
Chave de idempotência vazia para um aviso de liquidação	O `WebhookVerifier.idempotencyKey` atual extrai apenas identidades de eventos de fundos. Após as verificações de assinatura e propriedade, valide `notificationId` e crie a chave de aviso no código do comerciante. Nunca use uma chave vazia.
Notificação duplicada após processamento bem-sucedido	Persista a desduplicação no escopo do comerciante e `environment`. Retorne 2xx para duplicatas idênticas; registre conflitos e retorne não-2xx para o mesmo ID com um corpo diferente.
Aviso não processado	Aceite `liquidation.warning` e histórico `LIQUIDATION_WARNING`; não agrupe IDs de notificação distintos por usuário, episódio ou tipo de evento e descarte-os.
A notificação aceita perde sua tarefa pendente	Salve uma tarefa de forma confiável antes de retornar 2xx; iniciar uma tarefa assíncrona na memória é insuficiente.

Campos de evento e compatibilidade · HTTP respostas e reconhecimento confiável