Autocompletar KYC

Autocompletar KYC es el método de verificación por API de menor esfuerzo. No recopilas ni envías ningún campo de identidad: Fluz resuelve y verifica la identidad del cliente usando los datos ya registrados (como su número de teléfono) y devuelve una decisión en la misma respuesta. Úsalo como tu primer intento por API cuando quieras evitar recopilar datos de identidad del cliente por completo. Si se rechaza, recurre a la verificación por SSN o a solicitar una URL de IDV.

Requisitos previos

El scope VERIFY_KYC habilitado en tu aplicación por Fluz. Consulta Scope requerido.
Un token de acceso de usuario generado para el cliente que se está verificando, incluyendo VERIFY_KYC en sus scopes.
Un endpoint webhook registrado. Consulta Verificar clientes.

Cómo funciona

La mutación verifyUserPrefillInformation es sincrónica. El cliente se identifica completamente mediante el token de acceso de usuario: no hay entrada que recopilar ni validar. Fluz examina los datos del cliente registrados y devuelve APPROVED, DECLINED, DUPLICATE o ERROR en el cuerpo de la respuesta. Fluz también emite un evento de verificación a tu endpoint webhook, por lo que un solo handler puede procesar de forma consistente los resultados de cada método de verificación.

Autocompletar KYC se ejecuta una sola vez por cliente, ya sea que apruebe o rechace; una llamada repetida retorna sin reintentar la verificación.

Solicitud

El cliente que se está verificando se identifica por el token de acceso de usuario en el encabezado Authorization. No hay entrada que proporcionar.

Ejemplo

import { GraphQLClient, gql } from 'graphql-request';

const API_URL = 'https://transactional-graph.fluzapp.com/api/v1/graphql';

const VERIFY_USER_PREFILL_INFORMATION = gql`
  mutation verifyUserPrefillInformation {
    verifyUserPrefillInformation {
      status
      message
    }
  }
`;

const client = new GraphQLClient(API_URL, {
  headers: {
    Authorization: `Bearer <<USER_ACCESS_TOKEN>>`,
    'Content-Type': 'application/json',
  },
});

const response = await client.request(VERIFY_USER_PREFILL_INFORMATION);

console.log(response);

Response

{
  "data": {
    "verifyUserPrefillInformation": {
      "status": "APPROVED",
      "message": "User verification successful"
    }
  }
}

Manejo de la respuesta

Status	Qué hacer
`APPROVED`	El cliente está verificado. Desbloquea la funcionalidad correspondiente.
`DECLINED`	Escala a verificación por SSN o verificación por documentos.
`DUPLICATE`	El cliente está verificado, pero sus datos de identidad coinciden con los de otro cliente de Fluz. Trátalo como verificado y revisa posibles cuentas duplicadas de tu lado. Fluz no revela con qué cliente coincidió.
`ERROR`	Inspecciona `message`. El cliente ya está verificado o ha agotado sus intentos.

Pruebas

Consulta Probar flujos de KYC para la configuración general de staging: una cuenta de desarrollador, una aplicación activa y un token de acceso de usuario para el cliente que estás verificando.

Las identidades de prueba determinísticas de staging para Autocompletar KYC aún no están publicadas. Confirma los resultados esperados con el equipo de la plataforma antes de depender de ellas en una suite de pruebas automatizadas.

​Cómo funciona

​Solicitud

​Ejemplo

​Manejo de la respuesta

​Pruebas

Cómo funciona

Solicitud

Ejemplo

Manejo de la respuesta

Pruebas