SDK Solución de problemas de integración

Comience con el entorno, la marca de tiempo y el identificador comercial de la operación fallida. Una verificación estructurada generalmente separa los problemas de configuración de los problemas de autenticación, red y procesamiento asincrónico.

Orden de diagnóstico recomendado

Confirme el entorno afectado y la base URL.
Registre el rango de tiempo UTC y la primera solicitud fallida.
Identifique el módulo: Trading Widget, Agent SDK, REST API, WebSocket o webhook.
Capture el ID de solicitud, el ID de usuario del socio, agentOrderNo, el ID de pedido o el webhook ID de evento.
Verifique el código reciente, las credenciales, la IP lista blanca o los cambios de implementación.
Reproduzca con el caso de prueba seguro más pequeño.

Síntoma	causa probable	Arreglar
iframe solicita el dominio local del socio	baseUrl falta	Pase baseUrl: ‘https://app.6mm.com’.
iframe es invisible o muy corto	El contenedor principal no tiene altura	Establezca la altura del contenedor o la altura del paso.
token_provider_missing	el modo token de socio no tiene proveedor	Agregar autenticacióntokenProvider.
auth_exchange_failed	Token de inserción no válido, caducado o no coincidente	Verifique la respuesta del token de backend y channelId.

Agent SDK problemas

Síntoma	causa probable	Arreglar
Firma rechazada	Secreto incorrecto, desviación del reloj o campos firmados modificados manualmente	Deje que SDK genere campos de firma y sincronice la hora del servidor.
Riesgo de movimiento de fondos duplicados	Nuevo número de pedido utilizado después del tiempo de espera	Consulta primero por agentOrderNo original.
PROCESSING tratado como un fracaso	Estado pendiente mal entendido	Espere a webhook o llame a queryOrder.
Webhook procesado varias veces	Reintentar comportamiento sin idempotencia	Agregue clave de idempotencia y controles de estado final.

Evidencia para capturar

Integración	Evidencia útil
Trading Widget	Página URL, ruta de la versión SDK, consola del navegador, solicitudes de red fallidas, carga útil `onError` y dimensiones del contenedor.
Agent SDK	SDK idioma/versión, base URL, UTC marca de tiempo, ID de solicitud, `agentOrderNo`, código de respuesta y registros desinfectados.
Webhook	Tiempo de entrega, clave de evento o negocio, resultado de validación de firma, estado de procesamiento y hash de cuerpo sin procesar desinfectado.
REST API	Método, ruta, entorno, ID de solicitud, código de respuesta y parámetros desinfectados.

Nunca incluya contraseñas, tokens de acceso, API secretos, firmas completas, claves privadas o datos personales no redactados en los diagnósticos.

Antes de escalar

Vuelva a intentarlo solo cuando se documente que la operación es segura para volver a intentarlo.
Después de un tiempo de espera, consulte el identificador comercial original en lugar de crear uno nuevo.
Confirme el reloj del sistema y el entorno de credenciales para detectar errores de firma.
Conserve el primer error y los resultados de cualquier reintento posterior.
Utilice el Plantilla de solicitud de soporte para enviar un informe completo y redactado.

Documentos relacionados

Trading Widget Inicio rápido

Verifique la carga del script, el tamaño del contenedor, la configuración y las devoluciones de llamadas.

Secretos y firma

Verifique Agent SDK credenciales, relojes y campos firmados.

Webhooks & Idempotencia

Revise la verificación de devolución de llamadas y el manejo de eventos duplicados.

Java diagnóstico v0.3.0

Síntoma	Verificación y recuperación
La solicitud de financiación tiene un resultado desconocido	Conservar el `agentOrderNo` original; llame a `queryWalletTransfer` con el entorno original. No utilice `queryOrder`.
La interfaz de usuario de simulación muestra fondos inesperados	Verifique el frontend `tradingMode` por separado del backend `environment`; La cuenta `isSimulatedUser` no enruta solicitudes.
Error de consulta `6905`	Retroceda usando la cuota de socios compartidos, luego vuelva a intentar usar el mismo cursor y filtre a través de SDK.
Error de consulta `6904`	Reduzca las consultas simultáneas y reduzca la ventana de tiempo; Póngase en contacto con el soporte si persiste.
Cursor no válido o caducado	Reinicie la misma ventana del historial fijo y elimine los duplicados de los registros guardados.
Falta el nuevo método Java	Verifique el artefacto Maven resuelto con la etiqueta pública `v0.3.0`; elimine las dependencias en conflicto de acuerdo con su política de artefactos.

Referencia de consultas y errores · Guía de actualización

Webhook recibiendo problemas

Síntoma	Control y manejo
No hay reintento después de devolver el error JSON	Compruebe si el punto final todavía devuelve HTTP 200. La entrega utiliza solo el estado HTTP, no un indicador de éxito en el cuerpo.
Los reintentos continúan después de 401 o 409	Las respuestas que no sean 2xx siguen la política de reintento existente; investigar firmas, contenido de notificaciones o configuración del comerciante.
Clave de idempotencia vacía para una advertencia de liquidación	El `WebhookVerifier.idempotencyKey` actual solo extrae identidades de eventos de fondos. Después de las comprobaciones de firma y propiedad, valide `notificationId` y cree la clave de advertencia en el código de comerciante. Nunca utilices una clave vacía.
Notificación duplicada después de un procesamiento exitoso	Mantener la deduplicación dentro del alcance del comerciante y `environment`. Devuelve 2xx para duplicados idénticos; registre conflictos y devuelva no-2xx para la misma ID con un cuerpo diferente.
Advertencia no procesada	Aceptar `liquidation.warning` e histórico `LIQUIDATION_WARNING`; no agrupe ID de notificación distintos por usuario, episodio o tipo de evento y los descarte.
La notificación aceptada pierde su tarea pendiente	Guarde una tarea de manera confiable antes de regresar 2xx; iniciar una tarea asíncrona en memoria no es suficiente.

Campos de eventos y compatibilidad · HTTP respuestas y reconocimiento confiable