Seguridad y Operaciones

SDK Resolución de problemas de integración

Diagnostica Trading Widget, Agent SDK, firma, webhook, tiempo de espera y problemas de entorno antes de escalar una solicitud de soporte.
Ver como Markdown

Empieza por el entorno, la marca de tiempo y el identificador de negocio de la operación fallida. Una comprobación estructurada suele separar los problemas de configuración de los problemas de autenticación, red y procesamiento asincrónico.

Orden diagnóstico recomendado

  1. Confirmar el entorno y la base afectados URL.
  2. Registrar el intervalo de tiempo UTC y la primera petición que falle.
  3. Identificar el módulo: Trading Widget, Agent SDK, REST API, WebSocketo webhook.
  4. Capturar el ID de solicitud, ID de usuario del socio, agentOrderNo, ID de pedido o ID de evento webhook.
  5. Revisa el código reciente, credenciales, IP lista blanca o cambios en el despliegue.
  6. Reproduce con el caso de prueba más pequeño y seguro.

Trading Widget Problemas

SíntomaCausa probableArreglar
iframe solicita dominio local del sociobaseUrl faltaPaso baseUrl: ‘https://app.6mm.com’.
El iframe es invisible o muy bajoEl contenedor principal no tiene alturaEstablece la altura del contenedor o la altura de paso.
token_provider_missingEl modo partner-token no tiene proveedorAñade autorizacióntokenProvider.
auth_exchange_failedToken de embed inválido, caducado o desajustadoComprueba la respuesta del token backend y channelId.

Agent SDK Problemas

SíntomaCausa probableArreglar
Firma rechazadaSecreto incorrecto, deriva de reloj o campos de signos modificados manualmenteDeja SDK generar campos de firma y sincronizar el tiempo del servidor.
Riesgo de movimiento de fondos duplicadosNuevo número de pedido usado tras el tiempo muertoConsulta primero por agentOrderNo original.
PROCESSING tratan como un fracasoEstado pendiente malinterpretadoEspera a que aparezca el webhook o llama a queryOrder.
Webhook procesado varias vecesComportamiento de reintentar sin idempotenciaAñade la clave de idempotencia y las comprobaciones de estado final.

Pruebas a capturar

IntegraciónEvidencia útil
Trading WidgetPágina URL, ruta de SDK versión, consola del navegador, solicitudes fallidas de red, carga útil onError y dimensiones del contenedor.
Agent SDKSDK idioma/versión, URL base, UTC marca de tiempo, ID de la solicitud, agentOrderNo, código de respuesta y registros sanitizados.
WebhookTiempo de entrega, clave de evento o negocio, resultado de validación de firmas, estado de procesamiento y hash de cuerpo crudo sanitizado.
REST APIMétodo, ruta, entorno, ID de solicitud, código de respuesta y parámetros sanitizados.

Nunca incluyas contraseñas, tokens de acceso, API secretos, firmas completas, claves privadas o datos personales sin censurar en los diagnósticos.

Antes de escalar

  • Intentarlo solo cuando la operación esté documentada como segura para intentar de nuevo.
  • Tras un tiempo de espera, consulta el identificador original de negocio en lugar de crear uno nuevo.
  • Confirmar el reloj del sistema y el entorno de credenciales para detectar errores de firma.
  • Conservar el primer fallo y cualquier resultado posterior de reintentos.
  • Utilizar la Plantilla de Solicitud de Soporte para enviar un informe completo y redactado.
Trading Widget Inicio rápido

Verifica la carga de scripts, el tamaño del contenedor, la configuración y las devoluciones de llamada.

Secretos y firma

Revisa Agent SDK credenciales, relojes y campos firmados.

Webhooks e idempotencia

Revisa la verificación de llamadas y la gestión de eventos duplicados.