Crear verificación

crear verificación

curl --request POST \
  --url https://nufi.azure-api.net/kyb/verificaciones \
  --header 'Content-Type: application/json' \
  --header 'NUFI-API-KEY: <nufi-api-key>' \
  --header 'X-Workspace: <x-workspace>' \
  --data '
{
  "ProductKey": "AUTOPLAZO",
  "Modality": "Domiciliar",
  "FullName": "GUILLERMO ENRIQUEZ CHAPA",
  "Phone": "8112345678",
  "Email": "solicitante@correo.com",
  "Street": "Avenida Constitucion",
  "ExteriorNumber": "1500",
  "Neighborhood": "Centro",
  "Municipality": "Monterrey",
  "City": "Monterrey",
  "State": "Nuevo Leon",
  "PostalCode": "64000",
  "ExternalReference": "EXP-2026-00123",
  "SendLink": true
}
'

import requests

url = "https://nufi.azure-api.net/kyb/verificaciones"

payload = {
    "ProductKey": "AUTOPLAZO",
    "Modality": "Domiciliar",
    "FullName": "GUILLERMO ENRIQUEZ CHAPA",
    "Phone": "8112345678",
    "Email": "solicitante@correo.com",
    "Street": "Avenida Constitucion",
    "ExteriorNumber": "1500",
    "Neighborhood": "Centro",
    "Municipality": "Monterrey",
    "City": "Monterrey",
    "State": "Nuevo Leon",
    "PostalCode": "64000",
    "ExternalReference": "EXP-2026-00123",
    "SendLink": True
}
headers = {
    "NUFI-API-KEY": "<nufi-api-key>",
    "X-Workspace": "<x-workspace>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {
    'NUFI-API-KEY': '<nufi-api-key>',
    'X-Workspace': '<x-workspace>',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    ProductKey: 'AUTOPLAZO',
    Modality: 'Domiciliar',
    FullName: 'GUILLERMO ENRIQUEZ CHAPA',
    Phone: '8112345678',
    Email: 'solicitante@correo.com',
    Street: 'Avenida Constitucion',
    ExteriorNumber: '1500',
    Neighborhood: 'Centro',
    Municipality: 'Monterrey',
    City: 'Monterrey',
    State: 'Nuevo Leon',
    PostalCode: '64000',
    ExternalReference: 'EXP-2026-00123',
    SendLink: true
  })
};

fetch('https://nufi.azure-api.net/kyb/verificaciones', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://nufi.azure-api.net/kyb/verificaciones",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'ProductKey' => 'AUTOPLAZO',
    'Modality' => 'Domiciliar',
    'FullName' => 'GUILLERMO ENRIQUEZ CHAPA',
    'Phone' => '8112345678',
    'Email' => 'solicitante@correo.com',
    'Street' => 'Avenida Constitucion',
    'ExteriorNumber' => '1500',
    'Neighborhood' => 'Centro',
    'Municipality' => 'Monterrey',
    'City' => 'Monterrey',
    'State' => 'Nuevo Leon',
    'PostalCode' => '64000',
    'ExternalReference' => 'EXP-2026-00123',
    'SendLink' => true
  ]),
  CURLOPT_HTTPHEADER => [
    "Content-Type: application/json",
    "NUFI-API-KEY: <nufi-api-key>",
    "X-Workspace: <x-workspace>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://nufi.azure-api.net/kyb/verificaciones"

	payload := strings.NewReader("{\n  \"ProductKey\": \"AUTOPLAZO\",\n  \"Modality\": \"Domiciliar\",\n  \"FullName\": \"GUILLERMO ENRIQUEZ CHAPA\",\n  \"Phone\": \"8112345678\",\n  \"Email\": \"solicitante@correo.com\",\n  \"Street\": \"Avenida Constitucion\",\n  \"ExteriorNumber\": \"1500\",\n  \"Neighborhood\": \"Centro\",\n  \"Municipality\": \"Monterrey\",\n  \"City\": \"Monterrey\",\n  \"State\": \"Nuevo Leon\",\n  \"PostalCode\": \"64000\",\n  \"ExternalReference\": \"EXP-2026-00123\",\n  \"SendLink\": true\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("NUFI-API-KEY", "<nufi-api-key>")
	req.Header.Add("X-Workspace", "<x-workspace>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://nufi.azure-api.net/kyb/verificaciones")
  .header("NUFI-API-KEY", "<nufi-api-key>")
  .header("X-Workspace", "<x-workspace>")
  .header("Content-Type", "application/json")
  .body("{\n  \"ProductKey\": \"AUTOPLAZO\",\n  \"Modality\": \"Domiciliar\",\n  \"FullName\": \"GUILLERMO ENRIQUEZ CHAPA\",\n  \"Phone\": \"8112345678\",\n  \"Email\": \"solicitante@correo.com\",\n  \"Street\": \"Avenida Constitucion\",\n  \"ExteriorNumber\": \"1500\",\n  \"Neighborhood\": \"Centro\",\n  \"Municipality\": \"Monterrey\",\n  \"City\": \"Monterrey\",\n  \"State\": \"Nuevo Leon\",\n  \"PostalCode\": \"64000\",\n  \"ExternalReference\": \"EXP-2026-00123\",\n  \"SendLink\": true\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://nufi.azure-api.net/kyb/verificaciones")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["NUFI-API-KEY"] = '<nufi-api-key>'
request["X-Workspace"] = '<x-workspace>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"ProductKey\": \"AUTOPLAZO\",\n  \"Modality\": \"Domiciliar\",\n  \"FullName\": \"GUILLERMO ENRIQUEZ CHAPA\",\n  \"Phone\": \"8112345678\",\n  \"Email\": \"solicitante@correo.com\",\n  \"Street\": \"Avenida Constitucion\",\n  \"ExteriorNumber\": \"1500\",\n  \"Neighborhood\": \"Centro\",\n  \"Municipality\": \"Monterrey\",\n  \"City\": \"Monterrey\",\n  \"State\": \"Nuevo Leon\",\n  \"PostalCode\": \"64000\",\n  \"ExternalReference\": \"EXP-2026-00123\",\n  \"SendLink\": true\n}"

response = http.request(request)
puts response.read_body

{
  "Code": 200,
  "Status": "Success",
  "Message": "Verificación creada",
  "Data": {
    "Folio": "VD-2607-ZUZFKY",
    "VerificationId": "2aebab70-24f8-41c9-a17e-59f98a6f97a1",
    "VerificationStatus": "NoIniciado",
    "LinkSent": false,
    "ExternalReference": "EXP-2026-00123",
    "ExpiresAtUtc": "2026-08-04T23:37:42.218Z",
    "ApplicantUrl": "https://kyb.nufi.mx/v/6e7pzhbv?t=a29vVC9rQTBmeFBmODRCV0tBbG1mbWsxb0J0ZXo2QmtRaXJ2WmhHZzFRdz0"
  }
}

POST

verificaciones

crear verificación

curl --request POST \
  --url https://nufi.azure-api.net/kyb/verificaciones \
  --header 'Content-Type: application/json' \
  --header 'NUFI-API-KEY: <nufi-api-key>' \
  --header 'X-Workspace: <x-workspace>' \
  --data '
{
  "ProductKey": "AUTOPLAZO",
  "Modality": "Domiciliar",
  "FullName": "GUILLERMO ENRIQUEZ CHAPA",
  "Phone": "8112345678",
  "Email": "solicitante@correo.com",
  "Street": "Avenida Constitucion",
  "ExteriorNumber": "1500",
  "Neighborhood": "Centro",
  "Municipality": "Monterrey",
  "City": "Monterrey",
  "State": "Nuevo Leon",
  "PostalCode": "64000",
  "ExternalReference": "EXP-2026-00123",
  "SendLink": true
}
'

import requests

url = "https://nufi.azure-api.net/kyb/verificaciones"

payload = {
    "ProductKey": "AUTOPLAZO",
    "Modality": "Domiciliar",
    "FullName": "GUILLERMO ENRIQUEZ CHAPA",
    "Phone": "8112345678",
    "Email": "solicitante@correo.com",
    "Street": "Avenida Constitucion",
    "ExteriorNumber": "1500",
    "Neighborhood": "Centro",
    "Municipality": "Monterrey",
    "City": "Monterrey",
    "State": "Nuevo Leon",
    "PostalCode": "64000",
    "ExternalReference": "EXP-2026-00123",
    "SendLink": True
}
headers = {
    "NUFI-API-KEY": "<nufi-api-key>",
    "X-Workspace": "<x-workspace>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {
    'NUFI-API-KEY': '<nufi-api-key>',
    'X-Workspace': '<x-workspace>',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    ProductKey: 'AUTOPLAZO',
    Modality: 'Domiciliar',
    FullName: 'GUILLERMO ENRIQUEZ CHAPA',
    Phone: '8112345678',
    Email: 'solicitante@correo.com',
    Street: 'Avenida Constitucion',
    ExteriorNumber: '1500',
    Neighborhood: 'Centro',
    Municipality: 'Monterrey',
    City: 'Monterrey',
    State: 'Nuevo Leon',
    PostalCode: '64000',
    ExternalReference: 'EXP-2026-00123',
    SendLink: true
  })
};

fetch('https://nufi.azure-api.net/kyb/verificaciones', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://nufi.azure-api.net/kyb/verificaciones",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'ProductKey' => 'AUTOPLAZO',
    'Modality' => 'Domiciliar',
    'FullName' => 'GUILLERMO ENRIQUEZ CHAPA',
    'Phone' => '8112345678',
    'Email' => 'solicitante@correo.com',
    'Street' => 'Avenida Constitucion',
    'ExteriorNumber' => '1500',
    'Neighborhood' => 'Centro',
    'Municipality' => 'Monterrey',
    'City' => 'Monterrey',
    'State' => 'Nuevo Leon',
    'PostalCode' => '64000',
    'ExternalReference' => 'EXP-2026-00123',
    'SendLink' => true
  ]),
  CURLOPT_HTTPHEADER => [
    "Content-Type: application/json",
    "NUFI-API-KEY: <nufi-api-key>",
    "X-Workspace: <x-workspace>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://nufi.azure-api.net/kyb/verificaciones"

	payload := strings.NewReader("{\n  \"ProductKey\": \"AUTOPLAZO\",\n  \"Modality\": \"Domiciliar\",\n  \"FullName\": \"GUILLERMO ENRIQUEZ CHAPA\",\n  \"Phone\": \"8112345678\",\n  \"Email\": \"solicitante@correo.com\",\n  \"Street\": \"Avenida Constitucion\",\n  \"ExteriorNumber\": \"1500\",\n  \"Neighborhood\": \"Centro\",\n  \"Municipality\": \"Monterrey\",\n  \"City\": \"Monterrey\",\n  \"State\": \"Nuevo Leon\",\n  \"PostalCode\": \"64000\",\n  \"ExternalReference\": \"EXP-2026-00123\",\n  \"SendLink\": true\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("NUFI-API-KEY", "<nufi-api-key>")
	req.Header.Add("X-Workspace", "<x-workspace>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://nufi.azure-api.net/kyb/verificaciones")
  .header("NUFI-API-KEY", "<nufi-api-key>")
  .header("X-Workspace", "<x-workspace>")
  .header("Content-Type", "application/json")
  .body("{\n  \"ProductKey\": \"AUTOPLAZO\",\n  \"Modality\": \"Domiciliar\",\n  \"FullName\": \"GUILLERMO ENRIQUEZ CHAPA\",\n  \"Phone\": \"8112345678\",\n  \"Email\": \"solicitante@correo.com\",\n  \"Street\": \"Avenida Constitucion\",\n  \"ExteriorNumber\": \"1500\",\n  \"Neighborhood\": \"Centro\",\n  \"Municipality\": \"Monterrey\",\n  \"City\": \"Monterrey\",\n  \"State\": \"Nuevo Leon\",\n  \"PostalCode\": \"64000\",\n  \"ExternalReference\": \"EXP-2026-00123\",\n  \"SendLink\": true\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://nufi.azure-api.net/kyb/verificaciones")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["NUFI-API-KEY"] = '<nufi-api-key>'
request["X-Workspace"] = '<x-workspace>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"ProductKey\": \"AUTOPLAZO\",\n  \"Modality\": \"Domiciliar\",\n  \"FullName\": \"GUILLERMO ENRIQUEZ CHAPA\",\n  \"Phone\": \"8112345678\",\n  \"Email\": \"solicitante@correo.com\",\n  \"Street\": \"Avenida Constitucion\",\n  \"ExteriorNumber\": \"1500\",\n  \"Neighborhood\": \"Centro\",\n  \"Municipality\": \"Monterrey\",\n  \"City\": \"Monterrey\",\n  \"State\": \"Nuevo Leon\",\n  \"PostalCode\": \"64000\",\n  \"ExternalReference\": \"EXP-2026-00123\",\n  \"SendLink\": true\n}"

response = http.request(request)
puts response.read_body

{
  "Code": 200,
  "Status": "Success",
  "Message": "Verificación creada",
  "Data": {
    "Folio": "VD-2607-ZUZFKY",
    "VerificationId": "2aebab70-24f8-41c9-a17e-59f98a6f97a1",
    "VerificationStatus": "NoIniciado",
    "LinkSent": false,
    "ExternalReference": "EXP-2026-00123",
    "ExpiresAtUtc": "2026-08-04T23:37:42.218Z",
    "ApplicantUrl": "https://kyb.nufi.mx/v/6e7pzhbv?t=a29vVC9rQTBmeFBmODRCV0tBbG1mbWsxb0J0ZXo2QmtRaXJ2WmhHZzFRdz0"
  }
}

Alta de una verificación domiciliaria o laboral. El cliente crea la solicitud, la plataforma entrega al solicitante una liga de un solo uso (por SMS, correo o por el canal del propio cliente), y el solicitante completa el flujo desde su teléfono: consentimiento, validación biométrica, fotos con sello de ubicación y formulario.

Datos requeridos

ProductKey o ProductId: uno de los dos. Si mandas ambos, gana ProductId.
Modality: Domiciliar o Laboral (no es sensible a mayúsculas).
FullName: nombre del solicitante que recibirá la liga.
Phone o Email: al menos uno para entregarle la liga.

Datos opcionales

Domicilio declarado (Street, ExteriorNumber, Neighborhood, Municipality, City, State, PostalCode): contra el que se compara la ubicación real. Sin domicilio no hay comparación geográfica.
ExternalReference: tu folio o id. Se devuelve en todas las consultas.
SendLink: true por omisión (nosotros mandamos SMS/correo). false = solo se crea y se te devuelve la liga.

Ejemplo de request

{
  "ProductKey": "AUTOPLAZO",
  "Modality": "Domiciliar",
  "FullName": "GUILLERMO ENRIQUEZ CHAPA",
  "Phone": "8112345678",
  "Email": "solicitante@correo.com",
  "Street": "Avenida Constitucion",
  "ExteriorNumber": "1500",
  "Neighborhood": "Centro",
  "Municipality": "Monterrey",
  "City": "Monterrey",
  "State": "Nuevo Leon",
  "PostalCode": "64000",
  "ExternalReference": "EXP-2026-00123",
  "SendLink": true
}

Respuesta 200

Campo	Descripción
`Folio`	Folio de la verificación. `VD` = domiciliar, `VL` = laboral.
`VerificationId`	Identificador interno.
`VerificationStatus`	`Enviado` si la liga salió; `NoIniciado` si aún no.
`LinkSent`	`true` si el SMS o el correo salió correctamente.
`ExpiresAtUtc`	Vencimiento de la liga según el producto.
`ApplicantUrl`	Liga del solicitante.

La liga se entrega una sola vez. El token se guarda cifrado y no es reversible: ApplicantUrl solo viaja en esta respuesta. Guárdala de tu lado. Si se pierde, usa reenviar: genera una liga nueva e invalida la anterior.

Errores de validación (400)

Data trae todos los errores encontrados, no solo el primero. Mensajes posibles:

Se requiere ProductKey o ProductId
El campo Modality es obligatorio
El campo Modality debe ser Domiciliar o Laboral
El campo FullName es obligatorio
El campo FullName no debe exceder 200 caracteres
Se requiere Phone o Email para entregarle la liga al solicitante
El campo Phone no debe exceder 20 caracteres
El campo Email no debe exceder 200 caracteres
El campo Email no es válido
El campo ExternalReference no debe exceder 100 caracteres

Notas de integración

Cobro de mensajes. Cada SMS y cada correo se factura. Con SendLink: false no hay cargo de mensajería.
Reenvíos automáticos. Si el producto lo tiene configurado, la plataforma reenvía sola (por omisión a las 24, 48 y 72 h).
Idempotencia. El alta no es idempotente: dos POST idénticos crean dos verificaciones. Usa ExternalReference para detectar duplicados.
Vigencia. La liga vence según el producto (7 días por omisión).

Headers

NUFI-API-KEY

string

required

Llave de la API. También se acepta como x-functions-key o ?code= en la URL.

X-Workspace

string

required

Identificador del cliente (GUID). Determina el catálogo de productos disponible.

Body

application/json

Modality

enum<string>

required

Domiciliar o Laboral. No es sensible a mayúsculas.

Available options:

Domiciliar,

Laboral

FullName

string

required

Nombre del solicitante que recibirá la liga.

Maximum string length: 200

ProductKey

string

Clave del producto contratado (p. ej. AUTOPLAZO). Obligatorio si no se envía ProductId.

Maximum string length: 40

ProductId

string<uuid>

Alternativa a ProductKey. Si se envían ambos, gana ProductId.

Phone

string

10 dígitos. Se antepone 52 automáticamente si no lo trae. Obligatorio si no se envía Email.

Maximum string length: 20

string<email>

Destino del correo con la liga. Obligatorio si no se envía Phone.

Maximum string length: 200

Street

string

Calle del domicilio declarado.

ExteriorNumber

string

Número exterior del domicilio declarado.

Neighborhood

string

Colonia del domicilio declarado.

Municipality

string

Municipio del domicilio declarado.

City

string

Ciudad del domicilio declarado.

State

string

Estado del domicilio declarado.

PostalCode

string

Código postal del domicilio declarado.

ExternalReference

string

Folio o id externo. Se devuelve en consultas y es buscable por analistas.

Maximum string length: 100

SendLink

boolean

default:true

true = se envía SMS y/o correo. false = solo se crea y se devuelve la liga.

Response

Verificación creada

Code

integer

Example:

200

Status

string

Example:

"Success"

Message

string

Example:

"Verificación creada"

Data

object

Show child attributes

API documentation

Endpoints

Crear verificación

Datos requeridos

Datos opcionales

Ejemplo de request

Respuesta 200

Errores de validación (400)

Notas de integración

Headers

Body

Response

​Datos requeridos

​Datos opcionales

​Ejemplo de request

​Respuesta 200

​Errores de validación (400)

​Notas de integración

Headers

Body

Response

Datos requeridos

Datos opcionales

Ejemplo de request

Respuesta 200

Errores de validación (400)

Notas de integración