Sécurité et opérations

SDK Dépannage de l’intégration

Diagnostiquez Trading Widget, Agent SDK, signing, webhook, timeout et environnement avant d’escalader une demande de support.

Afficher en Markdown

Commencez par l’environnement, l’horodatage et l’identifiant métier de l’opération ratée. Un contrôle structuré sépare généralement les problèmes de configuration des problèmes d’authentification, de réseau et de traitement asynchrone.

Ordonnance diagnostique recommandée

  1. Confirmer l’environnement et la base URL affectés.
  2. Enregistrer la plage de temps UTC et la première demande échouée.
  3. Identifier le module : Trading Widget, Agent SDK, REST API, WebSocket, ou webhook.
  4. Capturez l’ID de la requête, l’identifiant utilisateur du partenaire, le agentOrderNo, l’identifiant de commande ou l’identifiant de l’événement webhook.
  5. Vérifier les modifications récentes du code, des identifiants, IP de la liste blanche ou du déploiement.
  6. Reproduire avec le plus petit cas sûr de test.

Trading Widget problèmes

SymptômeCause probableCorrection
iframe demande le domaine local partenairebaseUrl manquePassez baseUrl: «https://app.6mm.com».
iFrame est invisible ou très courtLe conteneur parent n’a pas de hauteurFixez la hauteur du contenant ou la hauteur de passage.
token_provider_missingLe mode partner-token n’a pas de fournisseurAjoutez l’authentificationtokenProvider.
auth_exchange_failedJeton d’intégration invalide, expiré ou mal assortiVérifiez la réponse des jetons backend et channelId.

Agent SDK problèmes

SymptômeCause probableCorrection
Signature rejetéeMauvais secret, dérive d’horloge, ou champs signés modifiés manuellementLaissez- SDK générer des champs de signature et synchroniser l’heure du serveur.
Risque de mouvement de fonds en doubleNouveau numéro de commande utilisé après un délai d’attenteRequête par agentOrderNo originale d’abord.
PROCESSING traité comme un échecÉtat en attente mal comprisAttendez le webhook ou appelez queryOrder.
Webhook traité plusieurs foisComportement de réessai sans idempotenceAjouter des vérifications de clé d’idempotence et d’état final.

Preuves à capturer

IntégrationPreuves utiles
Trading WidgetPage URL, chemin de SDK version, console du navigateur, requêtes réseau échouées, onError charge utile et dimensions du conteneur.
Agent SDKSDK langue/version, URL de base, UTC horodatage, ID de requête, agentOrderNo, code de réponse et journaux aseptisés.
WebhookDélai de livraison, clé d’événement ou métier, résultat de validation de signature, état de traitement et hachage du corps brut épuré.
REST APIMéthode, chemin, environnement, ID de requête, code de réponse et paramètres aseptisés.

N’incluez jamais de mots de passe, de jetons d’accès, de secrets API , de signatures complètes, de clés privées ou de données personnelles non expurgées dans les diagnostics.

Avant d’escalader

  • Réessayer uniquement lorsque l’opération est documentée comme sûre à retenter.
  • Après un temps d’attente, interroger l’identifiant d’entreprise original au lieu d’en créer un nouveau.
  • Confirmer l’horloge système et l’environnement des identifiants pour détecter les erreurs de signature.
  • Préserver le premier échec ainsi que les résultats de toute tentative ultérieure.
  • Utiliser le Modèle de demande de support pour envoyer un rapport complet et caviardé.
Trading Widget Départ rapide

Vérifiez le chargement du script, la taille du conteneur, la configuration et les rappels.

Secrets & Signature

Vérifiez Agent SDK identifiants, horloges et champs signés.

Webhooks et idempotence

Examinez la vérification des rappels et la gestion des événements en double.