SDK Resolução de problemas de integração

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

Ordem de diagnóstico recomendada

Confirme o ambiente afetado e a base URL.
Registe o intervalo de tempo UTC e o primeiro pedido com falha.
Identifique o módulo: Trading Widget, Agent SDK, REST API, WebSocket ou webhook.
Capte o ID do pedido, o ID do utilizador parceiro, agentOrderNo, o ID do pedido ou o ID do evento webhook.
Verifique o código recente, a credencial, a lista de permissões IP ou as alterações de implementação.
Reproduza com o mais pequeno caso de teste seguro.

Sintoma	Causa provável	Corrigir
iframe solicita domínio local do parceiro	baseUrl está em falta	Passe baseUrl: ‘https://app.6mm.com’.
iframe é invisível ou demasiado curto	O contentor 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 fornecedor	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	Corrigir
Assinatura rejeitada	Segredo errado, desvio de relógio ou campos assinados alterados manualmente	Deixe SDK gerar campos de assinatura e sincronizar a hora do servidor.
Risco de movimentação de fundos duplicados	Novo número de encomenda utilizado 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 captar

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

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

Antes de escalar

Tente novamente apenas 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 pedido 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 contentor, a configuração e as chamadas de retorno.

Segredos e assinatura

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

Webhooks e idempotência

Reveja 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 utilize `queryOrder`.
UI de simulação mostra fundos inesperados	Verifique o frontend `tradingMode` separadamente do backend `environment`; a conta `isSimulatedUser` não encaminha pedidos.
Erro de consulta `6905`	Recue utilizando a quota de parceiro partilhado, tente novamente o mesmo cursor e filtre por SDK.
Erro de consulta `6904`	Reduza as consultas simultâneas e restrinja a janela de tempo; contacte o suporte se persistir.
Cursor inválido ou expirado	Reinicie a mesma janela de histórico fixa e desduplique os registos guardados.
Novo método Java em falta	Verifique o artefacto Maven resolvido em relação à etiqueta pública `v0.3.0`; remova as dependências conflituantes de acordo com a sua política de artefactos.

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

Webhook problemas de recepção

Sintoma	Verificação e manuseamento
Nenhuma nova tentativa após o retorno da falha JSON	Verifique se o endpoint ainda retorna HTTP 200. A entrega utiliza apenas o estado HTTP, e 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 as assinaturas, o conteúdo da notificação ou a configuração do comerciante.
Chave de idempotência vazia para um aviso de liquidação	O `WebhookVerifier.idempotencyKey` atual apenas extrai 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 utilize uma chave vazia.
Notificação duplicada após processamento bem-sucedido	Persista a desduplicação no âmbito do comerciante e `environment`. Devolver 2xx para duplicados idênticos; registar conflitos e devolver 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 utilizador, episódio ou tipo de evento e elimine-os.
A notificação aceite perde a sua tarefa pendente	Guarde uma tarefa de forma fiável antes de retornar 2xx; iniciar uma tarefa assíncrona na memória é insuficiente.

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