Desarrolladores

Comienza la integración con un alcance claro.

Revisa estructura API, campos necesarios y respuestas. Define los controles adecuados para tu producto.

Datos de ejemplo
POST /v3/products · Idempotency-Key
{
  "product": "aml",
  "name": "Example Customer",
  "retention_years": 0
}

OpenAPI 3.1 · V3

Contratos API reales para su integración V3.

Descargue archivos OpenAPI 3.1 separados para la API regional, el procesamiento asignado y el acceso a medios. Utilice sus solicitudes, respuestas, permisos y formatos de error en su integración.

Autenticación en su backend

Mantenga la clave API Bearer vinculada al workspace en su backend. Las sesiones del panel seleccionan el workspace con X-Workspace-ID. No envíe esa clave a aplicaciones, navegadores ni servidores de procesamiento.

Persona y nueva sesión

Asocie su referencia estable de cliente con POST /v3/personas y cree los servicios seleccionados con POST /v3/onboardings. Entregue al dispositivo solo el session_token de esa sesión y datos de conexión de confianza. Un onboarding nuevo es un nuevo intento; una sesión vacía o en cola no genera cargos.

Carga directa al procesamiento asignado

Acepte una oferta de la cola con claim para recibir compute_url y compute_token. Cargue bytes directamente en ese origen, sin multipart. La grabación con IA envía fragmentos nuevos del mismo grabador. LiveKit solo se usa en videollamadas manuales.

Cola y resultados asíncronos

Siga la cola mediante su endpoint de estado o SSE autenticado. Una respuesta 202 de producto indica aceptación para procesamiento, no aprobación. Consulte el estado final en la API regional. Verifique firmas webhook sobre bytes originales y deduplique los ID; los eventos pueden llegar desordenados.

Reintentos, paginación y errores

Reintente la misma operación con el mismo cuerpo e Idempotency-Key. Pase next_cursor como after para la página siguiente. Actúe según error.code; actualice el estado ante 409 y respete Retry-After en 429/503. Los errores técnicos o de capacidad no son rechazos de identidad.

Entrega del SDK y alcance de versión

El candidato de integración V3 dev.2 incluye paquetes Node, Python, .NET y Java, además de un archivo de fuentes Go. No se ha publicado en registros públicos. Confirme la entrega, la verificación del manifiesto y la validación de plataformas con nuestro equipo. Los archivos OpenAPI no garantizan despliegue ni capacidad.

Ejemplo sintético V3; no se envía una solicitud real.

Primeros pasos

Primeras etapas de integración.

En cuatro etapas, define el alcance, configura el acceso seguro e implementa éxito, revisión y errores.

  1. 01
    Elige el producto.

    Define el control necesario y su alcance.

  2. 02
    Configura la autenticación.

    Usa las credenciales API en un servidor seguro.

  3. 03
    Ejecuta la solicitud de ejemplo.

    Respeta las condiciones del entorno de prueba.

  4. 04
    Implementa errores y revisión.

    No diseñes únicamente el caso exitoso.

Análisis de relaciones de transacciones

Elija red y profundidad para analizar carteras.

Consulte primero las redes activas en la respuesta regional wallet-capabilities. Envíe después chain y wallet_depth explícitos: 0 solo para listas de direcciones, 1 para contrapartes directas, 2 para directas e indirectas. La profundidad predeterminada es 2; códigos de activos como USDT no identifican una red.

  • Lea los resultados asíncronos con su alcanceObtenga GET /v3/products/{id} con el id de la creación. potential_match es un hallazgo en listas para revisión. no_match significa ausencia de coincidencias en la cobertura completada. inconclusive indica consulta incompleta; no lo use como aprobación automática. Conserve trace.complete, reasons, coverage, limitations y snapshot.

Se rechazan redes o direcciones inválidas y proveedores regionales inactivos antes de cobrar créditos. Mantenga las credenciales de API en el servidor. La dirección siguiente es solo un ejemplo de sintaxis; este ejemplo no realiza solicitudes de red.

Datos de ejemplo
POST /v3/products
{
  "product": "wallet_screening",
  "address": "0x1111111111111111111111111111111111111111",
  "chain": "ETH",
  "wallet_depth": 2,
  "retention_years": 0
}

Recursos

Recursos.

  • Guía de integración interactiva

    Elija controles y lenguaje para generar una guía paso a paso de sesiones, cargas directas y resultados.

    Guía de integración interactiva
  • API regional · OpenAPI JSON

    Descargue archivos OpenAPI 3.1 separados para la API regional, el procesamiento asignado y el acceso a medios. Utilice sus solicitudes, respuestas, permisos y formatos de error en su integración.

    Abrir referencia API V3
  • Guía de integración · Markdown en inglés

    Descargue la guía técnica en inglés sobre autenticación, sesiones y medios, verificación de webhooks e instalación de paquetes dev.2.

    Descargar la guía
  • Entrega del SDK y alcance de versión

    El candidato de integración V3 dev.2 incluye paquetes Node, Python, .NET y Java, además de un archivo de fuentes Go. No se ha publicado en registros públicos. Confirme la entrega, la verificación del manifiesto y la validación de plataformas con nuestro equipo. Los archivos OpenAPI no garantizan despliegue ni capacidad.

    Hablemos de su integración SDK V3
  • Estado del sistema

    Información actual del servicio.

    Página de estado

Antes de producción

Comprueba antes de pasar a producción.

Evalúa permisos, límites de solicitudes, reintentos, registros y datos sensibles según tu aplicación. Utiliza webhooks o idempotencia solo dentro del alcance documentado del endpoint correspondiente.

  • AutorizaciónClave secreta solo en servidor; nunca en código cliente.
  • Límites de solicitudesImplementa respuestas de límite y espera progresiva.
  • ReintentoSolo ante errores recuperables; con la misma referencia.
  • Registro de actividadIdentidad y datos de cartera enmascarados en los registros.
  • Tratamiento de datos sensiblesConservación y acceso conformes al contrato.
  • Estado de revisiónSe define un flujo del equipo para la respuesta «review_required».

Preguntas frecuentes

Sobre la integración.

¿Puedo incluir la clave API en una aplicación cliente?

No incluyas secretos en código cliente de acceso público. Sigue el modelo de autorización de la integración correspondiente.

¿Las respuestas de ejemplo son datos reales?

Los ejemplos están identificados como tales. Respuestas del producto real y datos de prueba se mantienen separados.

¿Tienes una consulta técnica?

Comparte tu escenario de integración. Aclaremos juntos producto y datos necesarios.