SDK Fehlerbehebung bei der Integration

Beginnen Sie mit der Umgebung, dem Zeitstempel und der Geschäftskennung für den fehlgeschlagenen Vorgang. Eine strukturierte Prüfung trennt normalerweise Konfigurationsprobleme von Authentifizierungs-, Netzwerk- und asynchronen Verarbeitungsproblemen.

Empfohlene Diagnosereihenfolge

Bestätigen Sie die betroffene Umgebung und Basis URL.
Notieren Sie den Zeitraum UTC und die erste fehlgeschlagene Anfrage.
Identifizieren Sie das Modul: Trading Widget, Agent SDK, REST API, WebSocket oder webhook.
Erfassen Sie die Anforderungs-ID, die Partnerbenutzer-ID, agentOrderNo, die Bestell-ID oder die webhook Ereignis-ID.
Überprüfen Sie aktuelle Code-, Anmeldeinformationen-, IP-Whitelist- oder Bereitstellungsänderungen.
Reproduzieren Sie mit dem kleinsten sicheren Testfall.

Symptom	Wahrscheinliche Ursache	Fix
iframe fordert lokale Partnerdomäne an	baseUrl fehlt	Übergeben Sie baseUrl: ‘https://app.6mm.com’.
Iframe ist unsichtbar oder sehr kurz	Der übergeordnete Container hat keine Höhe	Behälterhöhe oder Durchlaufhöhe einstellen.
token_provider_missing	Der Partner-Token-Modus hat keinen Anbieter	Authentifizierung hinzufügentokenProvider.
auth_exchange_failed	Ungültiges, abgelaufenes oder nicht übereinstimmendes Einbettungstoken	Überprüfen Sie die Antwort des Backend-Tokens und channelId.

Agent SDK Probleme

Symptom	Wahrscheinliche Ursache	Fix
Unterschrift abgelehnt	Falsches Geheimnis, Abweichung der Uhr oder manuell geänderte signierte Felder	Lassen Sie SDK Signaturfelder generieren und die Serverzeit synchronisieren.
Risiko doppelter Geldbewegungen	Nach Zeitüberschreitung wird neue Bestellnummer verwendet	Zuerst nach dem Original agentOrderNo abfragen.
PROCESSING wird als Fehler behandelt	Anhängiger Zustand missverstanden	Warten Sie auf webhook oder rufen Sie queryOrder an.
Webhook mehrfach verarbeitet	Wiederholungsverhalten ohne Idempotenz	Fügen Sie Idempotenzschlüssel- und Endzustandsprüfungen hinzu.

Beweise, die es zu erfassen gilt

Integration	Nützliche Beweise
Trading Widget	Seite URL, SDK Versionspfad, Browserkonsole, fehlgeschlagene Netzwerkanforderungen, `onError` Nutzlast und Containerabmessungen.
Agent SDK	SDK Sprache/Version, Basis URL, UTC Zeitstempel, Anforderungs-ID, `agentOrderNo`, Antwortcode und bereinigte Protokolle.
Webhook	Lieferzeit, Ereignis- oder Geschäftsschlüssel, Ergebnis der Signaturvalidierung, Verarbeitungsstatus und bereinigter Rohkörper-Hash.
REST API	Methode, Pfad, Umgebung, Anforderungs-ID, Antwortcode und bereinigte Parameter.

Beziehen Sie niemals Passwörter, Zugriffstokens, API Geheimnisse, vollständige Signaturen, private Schlüssel oder nicht redigierte persönliche Daten in die Diagnose ein.

Bevor es eskaliert

Versuchen Sie es nur erneut, wenn der Vorgang als sicher dokumentiert ist.
Fragen Sie nach einer Zeitüberschreitung die ursprüngliche Geschäftskennung ab, anstatt eine neue zu erstellen.
Überprüfen Sie die Systemuhr und die Anmeldeinformationsumgebung auf Signaturfehler.
Behalten Sie den ersten Fehler und alle späteren Wiederholungsergebnisse bei.
Benutzen Sie die Vorlage für Supportanfragen um einen vollständigen, redigierten Bericht zu senden.

Java v0.3.0 Diagnose

Symptom	Überprüfung und Wiederherstellung
Die Finanzierungsanfrage hat ein unbekanntes Ergebnis	Behalten Sie das Original `agentOrderNo`; Rufen Sie `queryWalletTransfer` mit der ursprünglichen Umgebung auf. Verwenden Sie nicht `queryOrder`.
Die Simulations-Benutzeroberfläche zeigt unerwartete Mittel an	Überprüfen Sie das Frontend `tradingMode` getrennt vom Backend `environment`; Konto `isSimulatedUser` leitet keine Anfragen weiter.
Abfragefehler `6905`	Nutzen Sie die gemeinsame Partnerquote nicht mehr und versuchen Sie es dann noch einmal mit dem gleichen Cursor und den gleichen Filtern durch SDK.
Abfragefehler `6904`	Reduzieren Sie gleichzeitige Abfragen und verengen Sie das Zeitfenster. Wenden Sie sich an den Support, wenn das Problem weiterhin besteht.
Ungültiger oder abgelaufener Cursor	Starten Sie dasselbe feste Verlaufsfenster neu und deduplizieren Sie gespeicherte Datensätze.
Fehlende neue Methode Java.	Überprüfen Sie das aufgelöste Maven-Artefakt anhand des öffentlichen Tags `v0.3.0`; Entfernen Sie widersprüchliche Abhängigkeiten gemäß Ihrer Artefaktrichtlinie.

Abfrage- und Fehlerreferenz · Upgrade-Anleitung

Webhook Probleme beim Empfang

Symptom	Kontrolle und Abwicklung
Kein erneuter Versuch nach erneutem Fehler JSON	Überprüfen Sie, ob der Endpunkt immer noch HTTP 200 zurückgibt. Bei der Zustellung wird nur der Status HTTP verwendet, kein Erfolgsindikator im Text.
Wiederholungsversuche werden nach 401 oder 409 fortgesetzt	Nicht-2xx-Antworten folgen der bestehenden Wiederholungsrichtlinie; Untersuchen Sie Signaturen, Benachrichtigungsinhalte oder Händlerkonfigurationen.
Leerer Idempotenzschlüssel für eine Liquidationswarnung	Der aktuelle `WebhookVerifier.idempotencyKey` extrahiert nur Fonds-Ereignisidentitäten. Validieren Sie nach der Signatur- und Eigentumsprüfung `notificationId` und erstellen Sie den Warnschlüssel im Händlercode. Verwenden Sie niemals einen leeren Schlüssel.
Doppelte Benachrichtigung nach erfolgreicher Bearbeitung	Behalten Sie die Deduplizierung innerhalb des Händler- und `environment`-Bereichs bei. Geben Sie 2xx für identische Duplikate zurück. Zeichnen Sie Konflikte auf und geben Sie Nicht-2xx für dieselbe ID mit einem anderen Text zurück.
Warnung nicht verarbeitet	Akzeptieren Sie `liquidation.warning` und historische `LIQUIDATION_WARNING`; Gruppieren Sie unterschiedliche Benachrichtigungs-IDs nicht nach Benutzer, Episode oder Ereignistyp und verwerfen Sie sie.
Eine angenommene Benachrichtigung verliert ihre ausstehende Aufgabe	Speichern Sie eine Aufgabe zuverlässig, bevor Sie 2xx zurückgeben. Das Starten einer asynchronen Aufgabe im Arbeitsspeicher reicht nicht aus.

Ereignisfelder und Kompatibilität · HTTP Antworten und zuverlässige Bestätigung