Saltar a contenido

Sumsub documentation extract (KYC/API provider)

Summary

Extracto de páginas clave de la documentación pública de Sumsub para evaluar su uso como proveedor KYC en Landbridge. La documentación cubre API REST para applicants, autenticación HMAC con app token, generación de access tokens para SDK, creación de applicants, subida de documentos, estados/review results, webhooks y modo Sandbox.

Key Points

  • Sumsub API permite procesar datos y documentos de applicants mediante APIs REST; se ofrecen Production y Sandbox sobre api.sumsub.com.
  • La autenticación exige X-App-Token, X-App-Access-Sig y X-App-Access-Ts; la firma es HMAC SHA-256 sobre timestamp, método HTTP, URI y body exacto.
  • El timestamp debe estar dentro de 1 minuto del tiempo del servidor API; todas las llamadas deben ir por HTTPS.
  • Para WebSDK/MobileSDK se genera un access token con POST https://api.sumsub.com/resources/accessTokens/sdk; el token puede limitarse a un applicant y su TTL depende de ttlInSecs.
  • La creación de applicant usa POST https://api.sumsub.com/resources/applicants, con levelName requerido como query param y externalUserId requerido en el body.
  • La subida de documentos usa multipart con metadata JSON y opcionalmente imagen/documento; soporta documentos de identidad, proof of address, income/payment source, company documents y otros tipos.
  • El endpoint GET https://api.sumsub.com/resources/applicants/{applicantId}/status devuelve reviewStatus, reviewResult, reviewAnswer, rejectLabels, reviewRejectType, comentarios y metadatos de intento.
  • Los estados relevantes incluyen init, pending, prechecked, queued, completed, onHold, awaitingService y awaitingUser.
  • Los resultados se interpretan principalmente vía reviewAnswer: GREEN aprobado y RED rechazado; reviewRejectType puede ser FINAL o RETRY.
  • Sumsub recomienda configurar webhooks para actualizaciones en tiempo real, especialmente applicantReviewed, y documenta eventos como applicantCreated, applicantPending, applicantOnHold, applicantAwaitingService y muchos otros.
  • Sandbox permite probar integración, app tokens, webhooks y WebSDK; tiene límite de 500 applicant profiles por 24 horas y no ejecuta algoritmos reales de aprobación.
  • La documentación de user verification destaca flujos KYC/AML configurables, lógica no-code y prevención de fraude/document templates.

Evidence

  • “With the Sumsub API, you can process the applicant data and documents submitted for verification through simple RESTful APIs.”
  • “API access is regulated through the use of the X-App-Token authorization header” y la página de Authentication detalla X-App-Access-Sig/X-App-Access-Ts.
  • “To receive real-time updates on verification statuses, it is necessary to configure webhooks (primarily applicantReviewed).”
  • “Use Sandbox mode to test your integration before going live” y “Sandbox mode has no approval algorithms”.
  • La referencia “Get applicant review status” define GREEN como aprobado y RED como declinado; FINAL impide resubmission y RETRY permite resubir documentos.
  • “Add verification documents” lista tipos como PASSPORT, ID_CARD, DRIVERS, UTILITY_BILL, INCOME_SOURCE, PAYMENT_SOURCE, COMPANY_DOC y subtipos societarios.

Open Questions

  • Determinar qué verification level concreto necesita Landbridge para compras inmobiliarias: ID+liveness, proof of address, source of funds, payment source, company/KYB o combinaciones.
  • Confirmar si Sumsub puede entregar paquetes de evidencia aceptables para underwriters/title companies en EE. UU., no solo estados API.
  • Validar pricing, tiempos de revisión, cobertura de jurisdicciones, soporte para compradores internacionales y controles específicos de crypto source of funds.
  • Diseñar arquitectura de custodia de datos: qué guarda Landbridge, qué queda en Sumsub, y qué se comparte con title/underwriter.
  • Definir estrategia de webhooks, reintentos, reconciliación y logs auditables para cierre inmobiliario.
  • https://docs.sumsub.com/reference/about-sumsub-api
  • https://docs.sumsub.com/reference/authentication
  • https://docs.sumsub.com/reference/generate-access-token
  • https://docs.sumsub.com/reference/create-applicant
  • https://docs.sumsub.com/reference/add-verification-documents
  • https://docs.sumsub.com/reference/get-applicant-review-status
  • https://docs.sumsub.com/docs/receive-and-interpret-results-via-api
  • https://docs.sumsub.com/docs/applicant-statuses
  • https://docs.sumsub.com/docs/webhooks
  • https://docs.sumsub.com/docs/user-verification-webhooks
  • https://docs.sumsub.com/docs/test-in-sandbox
  • https://docs.sumsub.com/docs/user-verification
  • [[entity-sumsub]]
  • [[concept-proveedores-kyc]]