KYC para Clientes Individuales

KYC (Know Your Customer) es un proceso legal de verificación de identidad requerido antes de que cualquier cliente individual pueda enviar o recibir fondos a través de SpherePay. Es obligatorio por regulaciones de anti-lavado de dinero (AML) y debe completarse una vez por cliente. Tú eliges cómo integrar — vía API o enlace alojado — y qué modelo de cumplimiento usar.

Información requerida

SpherePay requiere la siguiente información para verificar la identidad de un cliente individual. Los campos marcados como API se envían en la solicitud de creación de cliente; los campos marcados como Documento de identidad se extraen automáticamente del documento cargado.

Campo	Origen	Notas
Dirección de correo electrónico	API	Campo `email` en la solicitud de creación de cliente
Número de teléfono	API	Campo `phone` en la solicitud de creación de cliente
País de residencia	API	`address.country` en la solicitud de creación de cliente
Dirección residencial	API	Objeto `address` completo (calle, ciudad, código postal, estado)
Número de identificación fiscal	API	`personalInformation.taxIdentificationNumber` — los tipos aceptados varían por país
Nombre y apellido	Documento de identidad	Extraído automáticamente del ID emitido por el gobierno cargado
Fecha de nacimiento	Documento de identidad	Extraído automáticamente del ID emitido por el gobierno cargado
Documento de identidad emitido por el gobierno	Documento de identidad	Cargado vía `POST /v2/document` — pasaporte, tarjeta de identidad o licencia de conducir
Comprobante de domicilio	Documento de identidad	Cargado vía `POST /v2/document`

Los clientes individuales residentes en la región EEA+ también deben proporcionar accountPurpose, countryOfBirth y nationality antes de la verificación. Consulta Residentes EEA+.

En ciertas circunstancias SpherePay puede solicitar información adicional, como para personas políticamente expuestas (PEPs), clientes mayores, perfiles de alto riesgo o clientes con volúmenes de transacciones esperados inusualmente altos. SpherePay se pondrá en contacto contigo directamente cuando esto aplique.

Resumen del flujo KYC

El flujo a continuación muestra los pasos requeridos para el KYC individual. El único paso que difiere entre modelos de incorporación es la aceptación de TOS — se maneja en el flujo en Sphere-Managed y está integrada en los términos de tu plataforma en Platform-Managed.

Sphere-Managed (por defecto)
Platform-Managed (opt-in)

Crear cliente con personalInformation y address completos
Generar enlace TOS → redirigir al cliente para aceptar los términos
Cargar documento de identidad emitido por el gobierno
Cargar comprobante de domicilio
Completar verificación de vivacidad facial (SDK de Sumsub, en el flujo)
Consultar GET /v2/customer/{id} hasta que status alcance approved

Crear cliente con personalInformation y address completos
Cargar documento de identidad emitido por el gobierno
Cargar comprobante de domicilio
Cargar documento de informe de vivacidad de tu proveedor KYC
Consultar GET /v2/customer/{id} hasta que status alcance approved

Elegir un método de integración

Debes elegir un único método de integración y modelo de incorporación para cada cliente. Mezclar métodos para el mismo cliente — o recurrir a uno si el otro falla — no está soportado y resultará en una incorporación fallida.

KYC vía API — Sphere-Managed

Modelo por defecto. Sphere maneja TOS, vivacidad facial y OTP vía enlaces alojados.

KYC vía API — Platform-Managed

Modelo opt-in. Carga un documento de informe de vivacidad. No se requieren redireccionamientos alojados.

KYC vía enlace alojado

Integración más rápida. SpherePay aloja toda la experiencia de verificación.

KYC vía API — Sphere-Managed

Este es el modelo por defecto para todas las nuevas integraciones API. Sphere maneja los pasos de cumplimiento en el flujo usando enlaces alojados y redireccionamientos: aceptación de Términos de Servicio, verificación de vivacidad facial y verificación de contacto OTP. Antes de comenzar, asegúrate de tener:

Una clave API de SpherePay
La información personal del cliente (dirección completa, ID fiscal)
Una copia del documento de identidad emitido por el gobierno del cliente

Crear un cliente

Llama a POST /v2/customer con type: "individual" e incluye los objetos completos personalInformation y address. Estos campos permiten a SpherePay verificar la identidad del cliente de forma programática.

{
  "type": "individual",
  "email": "jane.smith@example.com",
  "phone": "+14155550123",
  "address": {
    "line1": "233 South Wacker Drive",
    "line2": "Suite 4700",
    "city": "Chicago",
    "postalCode": "60606",
    "state": "IL",
    "country": "USA"
  },
  "personalInformation": {
    "taxIdentificationNumber": "123456789",
    "taxIdentificationNumberType": "ssn",
    "taxIdentificationNumberCountry": "USA"
  }
}

El objeto personalInformation acepta los siguientes campos:

Campo	Descripción
`taxIdentificationNumberCountry`	El código de país del cliente (p. ej. `USA`, `SGP`, `GBR`)
`taxIdentificationNumberType`	El tipo de número de identificación, p. ej. `ssn` (EE. UU.), `nric` (Singapur), `nino` (Reino Unido)
`taxIdentificationNumber`	El número de identificación real
`taxIdentificationNumberDescription`	Descripción legible — solo requerida cuando el tipo es `other`
`accountPurpose`	Por qué el cliente abre la cuenta. Requerido para residentes EEA+ antes de la verificación — consulta Residentes EEA+
`countryOfBirth`	País de nacimiento en ISO 3166-1 alpha-3. Requerido para residentes EEA+ antes de la verificación
`nationality`	Nacionalidad en ISO 3166-1 alpha-3. Requerida para residentes EEA+ antes de la verificación

Aceptar los Términos de Servicio

Genera un enlace TOS y redirige al cliente para aceptar los Términos y Condiciones y la Política de Privacidad.

POST https://api.spherepay.co/v2/customer/{id}/tos-link

Este paso puede realizarse en paralelo con la carga de documentos.

Cargar documento de identidad

Carga el documento de identidad emitido por el gobierno del cliente usando POST /v2/document.

curl --location 'https://api.spherepay.co/v2/document' \
--header 'Authorization: Bearer <your_api_key>' \
--form 'target="customer"' \
--form 'targetId="customer_4914a2f6226e42cc8d207ead9573b29f"' \
--form 'documentType="id_card"' \
--form 'side="front"' \
--form 'file=@"/path/to/your/document.jpg"' \
--form 'country="SGP"'

Carga tanto el frente como el reverso para tarjetas de identidad y licencias de conducir. Los pasaportes requieren solo el frente (con excepciones específicas por país). Consulta la Guía de Documentos para los formatos aceptados por país.

Completar la verificación de vivacidad facial

Verifica el arreglo required del cliente vía GET /v2/customer/{id}. Luego realiza exactamente una de las siguientes opciones, dependiendo de lo que aparezca en required:

liveness_check en required — Genera un enlace de verificación facial vía POST /v2/enhanced-due-diligence/face-verification-link y redirige al cliente para completar una verificación de vivacidad interactiva vía el SDK de Sumsub.
liveness_report_document en required — Carga un documento de informe de vivacidad de tu proveedor de verificación de identidad vía POST /v2/document con documentType: "liveness_report".

No realices ambos caminos. Verifica el arreglo required y sigue solo la opción correspondiente.

Consultar resultado de verificación

Una vez que todos los pasos requeridos estén completos, SpherePay procesa la verificación automáticamente — no se necesita ninguna llamada de envío. Consulta GET /v2/customer/{id} hasta que status en verificationProfiles alcance approved.

GET https://api.spherepay.co/v2/customer/{id}

{
  "id": "customer_f31121c389624d3697cbf3ea8830b7a4",
  "email": "jane.smith@example.com",
  "phone": "+14155550123",
  "verificationProfiles": [
    {
      "name": "kyc_profile_a",
      "status": "approved",
      "criteria": {
        "complete": [
          "email_address",
          "phone_number",
          "residential_address",
          "tax_identification_number",
          "identity_document",
          "liveness_report_document"
        ],
        "pending": [],
        "required": [],
        "errors": []
      }
    }
  ],
  "createdAt": "2026-03-09T20:46:31.305Z",
  "updatedAt": "2026-03-09T20:46:31.305Z",
  "type": "individual"
}

Cuando required esté vacío y status sea approved, el cliente está completamente incorporado y listo para transferir.

La revisión KYC generalmente toma 0–2 días hábiles después de que se envíen todos los documentos y datos requeridos.

KYC vía API — Platform-Managed

Este modelo opt-in es para plataformas que ya realizan KYC, recopilan verificación de vivacidad e integran los Términos de Servicio de Sphere. Tu plataforma maneja el cumplimiento de forma previa — no se requieren redireccionamientos alojados.

Platform-Managed no está disponible por defecto. Tu plataforma debe cumplir los requisitos de calificación y recibir aprobación del equipo de Cumplimiento de Sphere antes de salir en vivo. Contacta a tu Ingeniero de Soluciones dedicado para iniciar el proceso de aprobación.

Requisitos previos adicionales más allá del conjunto estándar:

Un documento de informe de vivacidad de tu proveedor de verificación de identidad (p. ej. Sumsub, Persona)
Incorporación Platform-Managed aprobada para tu aplicación por el Área de Cumplimiento de Sphere

Crear un cliente

Llama a POST /v2/customer con type: "individual", personalInformation completo y address. El cuerpo de la solicitud es idéntico al del camino Sphere-Managed.

{
  "type": "individual",
  "email": "jane.smith@example.com",
  "phone": "+14155550123",
  "address": {
    "line1": "233 South Wacker Drive",
    "line2": "Suite 4700",
    "city": "Chicago",
    "postalCode": "60606",
    "state": "IL",
    "country": "USA"
  },
  "personalInformation": {
    "taxIdentificationNumber": "123456789",
    "taxIdentificationNumberType": "ssn",
    "taxIdentificationNumberCountry": "USA"
  }
}

Cargar documento de identidad y comprobante de domicilio

Carga los documentos de identidad del cliente vía POST /v2/document. Repite para cada tipo de documento requerido.

curl --location 'https://api.spherepay.co/v2/document' \
--header 'Authorization: Bearer <your_api_key>' \
--form 'target="customer"' \
--form 'targetId="customer_4914a2f6226e42cc8d207ead9573b29f"' \
--form 'documentType="id_card"' \
--form 'side="front"' \
--form 'file=@"/path/to/your/document.jpg"' \
--form 'country="SGP"'

Cargar informe de vivacidad

Carga el informe de vivacidad producido por tu proveedor de verificación de identidad. Esto reemplaza la verificación de vivacidad facial en el flujo usada en Sphere-Managed.

curl --location 'https://api.spherepay.co/v2/document' \
--header 'Authorization: Bearer <your_api_key>' \
--form 'target="customer"' \
--form 'targetId="customer_4914a2f6226e42cc8d207ead9573b29f"' \
--form 'documentType="liveness_report"' \
--form 'file=@"/path/to/liveness_report.pdf"'

Solo carga este documento si liveness_report_document aparece en el arreglo required del perfil de verificación del cliente.

Consultar resultado de verificación

Una vez que todos los datos y documentos requeridos estén enviados, SpherePay procesa la verificación KYC automáticamente. Consulta GET /v2/customer/{id} hasta que status alcance approved.

EEA+ residents

Sphere exige campos KYC adicionales para clientes individuales residentes en la región EEA+, en línea con MiCA. Los clientes fuera de EEA+ no se ven afectados. EEA+ es el EEE más el Reino Unido, Suiza, Andorra y varios territorios de ultramar de la UE (Islas Åland, Guayana Francesa, Guadalupe, Martinica, Mayotte, Reunión, San Martín). El alcance se determina por el país de residencia del cliente (address.country). Consulta Región EEA+ para la definición completa.

Campos adicionales

Proporciona estos campos bajo personalInformation en POST /v2/customer y PATCH /v2/customer/{id}:

Campo	Estado	Formato	Requerido para EEA+ antes de la verificación
`accountPurpose`	Nuevo	`enum` — consulta los valores abajo	Sí
`countryOfBirth`	Existente	ISO 3166-1 alpha-3	Sí
`nationality`	Existente	ISO 3166-1 alpha-3	Sí

Valores aceptados de accountPurpose:

personal_or_living_expenses
payments_to_friends_or_family_abroad
receive_salary
receive_payment_for_freelancing
protect_wealth
purchase_goods_and_services
charitable_donations
ecommerce_retail_payments
investment_purposes
operating_a_company

Cuándo Sphere exige estos campos

Estos campos no son obligatorios en la creación. POST /v2/customer y PATCH /v2/customer/{id} se completan sin ellos, para que puedas completar un cliente de forma incremental. Hasta que se proporcionen los tres, aparecen en los criterios kyc_profile_a del cliente como country_of_birth, nationality y account_purpose, y el cliente no puede enviarse a verificación. Sphere excluye estos códigos por completo para clientes cuyo país de residencia está fuera de EEA+. Puedes completar clientes EEA+ existentes con PATCH /v2/customer/{id}. La validación se ejecuta sobre el estado combinado del cliente — envía solo los campos faltantes.

Registro fiscal extranjero

Si taxIdentificationNumberCountry difiere del país de residencia del cliente (address.country), Sphere registra un registro fiscal extranjero y lo reenvía al proveedor de verificación. No envías un campo separado para esto.

Ejemplo

Llama a POST /v2/customer con los campos EEA+ bajo personalInformation:

{
  "type": "individual",
  "firstName": "Anna",
  "lastName": "Lindqvist",
  "address": { "country": "SWE" },
  "personalInformation": {
    "countryOfBirth": "FIN",
    "nationality": "SWE",
    "accountPurpose": "receive_salary"
  }
}

El ejemplo destaca los campos EEA+. Incluye los demás campos del cliente requeridos en la creación (email, phone y un address completo) como de costumbre.

Qué sigue

Una vez que el perfil de verificación del cliente sea approved, registra sus métodos de pago e inicia una transferencia.

Cuentas bancarias

Registra una cuenta bancaria para que el cliente pueda enviar o recibir fondos vía riel bancario.

Billeteras

Registra una dirección de billetera cripto para habilitar transferencias on-ramp y off-ramp.

API de Transferencias

Crea y gestiona transferencias una vez que el cliente haya registrado sus métodos de pago.

Perfil de verificación

Entiende los estados de verificación, arreglos de criterios y qué desencadena los cambios de estado.

Incorporación

Transferencias

Automatización

Webhooks

Datos de referencia

Operacional

KYC para Clientes Individuales

Información requerida

Resumen del flujo KYC

Elegir un método de integración

KYC vía API — Sphere-Managed

KYC vía API — Platform-Managed

KYC vía enlace alojado

KYC vía API — Sphere-Managed

KYC vía API — Platform-Managed

EEA+ residents

Campos adicionales

Cuándo Sphere exige estos campos

Registro fiscal extranjero

Ejemplo

Qué sigue

Cuentas bancarias

Billeteras

API de Transferencias

Perfil de verificación

​Información requerida

​Resumen del flujo KYC

​Elegir un método de integración

KYC vía API — Sphere-Managed

KYC vía API — Platform-Managed

KYC vía enlace alojado

​KYC vía API — Sphere-Managed

​KYC vía API — Platform-Managed

​EEA+ residents

​Campos adicionales

​Cuándo Sphere exige estos campos

​Registro fiscal extranjero

​Ejemplo

​Qué sigue

Cuentas bancarias

Billeteras

API de Transferencias

Perfil de verificación

Información requerida

Resumen del flujo KYC

Elegir un método de integración

KYC vía API — Sphere-Managed

KYC vía API — Platform-Managed

EEA+ residents

Campos adicionales

Cuándo Sphere exige estos campos

Registro fiscal extranjero

Ejemplo

Qué sigue