Sicurezza e Operazioni

SDK Risoluzione dei problemi di integrazione

Diagnostica problemi di Trading Widget, Agent SDK, firma, webhook, timeout e ambiente prima di escalare una richiesta di supporto.
Visualizza come Markdown

Inizia dall’ambiente, dall’ora e dall’identificatore aziendale per l’operazione fallita. Un controllo strutturato di solito separa i problemi di configurazione da quelli di autenticazione, di rete e di elaborazione asincrona.

Ordine diagnostico raccomandato

  1. Confermare l’ambiente e la URL di base interessati.
  2. Registra l’intervallo di tempo UTC e la prima richiesta fallita.
  3. Identifica il modulo: Trading Widget, Agent SDK, REST API, WebSocketo webhook.
  4. Cattura l’ID richiesta, l’ID utente partner, agentOrderNo, l’ID ordine o l’ID evento webhook.
  5. Controlla codice, credenziali, whitelist IP o modifiche al deployment.
  6. Riprodurre con il caso di prova più piccolo e sicuro.

Trading Widget problemi

SintomoCausa probabileFissaggio
iframe richiede il dominio locale partnerbaseUrl mancaPasso baseUrl: ‘https://app.6mm.com’.
iframe è invisibile o molto cortoIl contenitore genitore non ha altezzaImposta l’altezza del contenitore o l’altezza del passaggio.
token_provider_missingLa modalità partner-token non ha un providerAggiungi autenticazionetokenProvider.
auth_exchange_failedToken embed invalido, scaduto o non corrispondenteControlla la risposta del token backend e channelId.

Agent SDK problemi

SintomoCausa probabileFissaggio
Firma respintaSegreto sbagliato, deriva di clock o cambiato manualmente i campi firmatiLascia SDK generare campi di firma e sincronizzare il tempo del server.
Rischio di movimento di fondi duplicatiNuovo numero d’ordine usato dopo il timeoutPrima invia la query per agentOrderNo originale.
PROCESSING trattato come fallimentoStato in attesa fraintesoAspetta il webhook o chiama queryOrder.
Webhook elaborato più volteComportamento di riprova senza idempotenzaAggiungi la chiave di idempotenza e i controlli di stato finale.

Prove da catturare

IntegrazioneProve utili
Trading WidgetPagina URL, percorso SDK versione, console browser, richieste di rete fallite, payload onError e dimensioni del container.
Agent SDKSDK lingua/versione, URL base, UTC timestamp, ID richiesta, agentOrderNo, codice di risposta e log sanificati.
WebhookTempo di consegna, chiave di evento o business, risultato di validazione della firma, stato di elaborazione e hash del corpo grezzo sanitizzato.
REST APIMetodo, percorso, ambiente, ID richiesta, codice di risposta e parametri sanificati.

Non includere mai password, token di accesso, API segreti, firme complete, chiavi private o dati personali non oscurati nelle diagnostiche.

Prima di degenerare

  • Ritentare solo quando l’operazione è documentata come sicura da riprovare.
  • Dopo un timeout, interrogare l’identificativo originale dell’azienda invece di crearne uno nuovo.
  • Confermare l’orologio di sistema e l’ambiente delle credenziali per errori di firma.
  • Conservare il primo fallimento e eventuali risultati di ritenti successivi.
  • Utilizzare il Modello di Richiesta di Supporto per inviare un report completo e oscurato.
Trading Widget Avvio rapido

Verifica il caricamento degli script, la dimensione del container, la configurazione e i callback.

Segreti e firma

Controlla Agent SDK credenziali, orologi e campi firmati.

Webhook e idempotenza

Rivedi la verifica del callback e la gestione degli eventi duplicati.