Seguridad y Operaciones

SDK Solución de Problemas de Integración

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

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

Orden diagnóstico recomendado

  1. Confirmar el ambiente y la base afectados URL.
  2. Registrar el rango de tiempo UTC y la primera solicitud que falle.
  3. Identificar el módulo: Trading Widget, Agent SDK, REST API, WebSocket, o webhook.
  4. Captura el ID de solicitud, ID de usuario del socio, agentOrderNo, ID de pedido o ID de evento webhook.
  5. Revisa códigos recientes, credenciales, lista blanca de IP 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 faltaPásame baseUrl: ‘https://app.6mm.com’.
El iframe es invisible o muy bajoEl contenedor padre no tiene alturaEstablece la altura del contenedor o la altura de pasar.
token_provider_missingEl modo partner-token no tiene proveedorAgrega autorizacióntokenProvider.
auth_exchange_failedToken de embed inválido, expirado o no coincidenteRevisa la respuesta del token backend y channelId.

Agent SDK problemas

SíntomaCausa probableArreglar
Firma rechazadaSecreto incorrecto, deriva de reloj o campos de signos cambiados manualmenteDeja SDK generar campos de firma y sincronizar el tiempo del servidor.
Riesgo de movimiento de fondos duplicadosNuevo número de orden usado después del tiempo fueraConsulta por agentOrderNo original primero.
PROCESSING tratado como fracasoEstado pendiente malinterpretadoEspera el webhook o llama a queryOrder.
Webhook procesado varias vecesComportamiento de reintento sin idempotenciaAgrega la clave de idempotencia y las verificaciones de estado final.

Evidencia a capturar

IntegraciónEvidencia útil
Trading WidgetPágina URL, SDK ruta de 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 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 no redactados en diagnósticos.

Antes de escalar

  • Reintentar solo cuando la operación esté documentada como segura para reintentar.
  • Después de un tiempo fuera, consulta el identificador original del negocio en lugar de crear uno nuevo.
  • Confirmar el reloj del sistema y el entorno de credenciales para detectar errores de firma.
  • Preservar el primer fracaso y cualquier resultado posterior de reintentos.
  • Usar la Plantilla de Solicitud de Soporte para enviar un reporte completo y redactado.
Trading Widget Inicio Rápido

Verifica la carga de scripts, tamaño del contenedor, configuración y callbacks.

Secretos y firmas

Revisa Agent SDK credenciales, relojes y campos firmados.

Webhooks e Idempotencia

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