Obtener URL de Verificación KYC

curl --request GET \
  --url http://api.gu1.ai/api/kyc/validations/{id} \
  --header 'Authorization: Bearer <token>'

const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

fetch('http://api.gu1.ai/api/kyc/validations/{id}', 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 => "http://api.gu1.ai/api/kyc/validations/{id}",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>"
  ],
]);

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

curl_close($curl);

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

package main

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

func main() {

	url := "http://api.gu1.ai/api/kyc/validations/{id}"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("Authorization", "Bearer <token>")

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

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

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("http://api.gu1.ai/api/kyc/validations/{id}")

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

request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'

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

GET

api

kyc

validations

{id}

Obtener URL de Verificación KYC

curl --request GET \
  --url http://api.gu1.ai/api/kyc/validations/{id} \
  --header 'Authorization: Bearer <token>'

const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

fetch('http://api.gu1.ai/api/kyc/validations/{id}', 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 => "http://api.gu1.ai/api/kyc/validations/{id}",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>"
  ],
]);

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

curl_close($curl);

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

package main

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

func main() {

	url := "http://api.gu1.ai/api/kyc/validations/{id}"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("Authorization", "Bearer <token>")

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

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

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("http://api.gu1.ai/api/kyc/validations/{id}")

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

request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'

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

Resumen

Después de crear una validación KYC, puedes recuperar la URL de verificación en cualquier momento. Esta URL es la que compartirás con tu cliente para que complete el proceso de verificación de identidad.

Cuándo Usar Esto

Recuperar URL después: Si no guardaste la URL de la respuesta de creación
Reenviar al cliente: Cuando el cliente solicita un nuevo enlace
Verificar detalles: Ver estado actual y metadata
Integrar con otros sistemas: Pasar la URL a servicios de notificación

Solicitud

Endpoint

GET https://api.gu1.ai/api/kyc/validations/{id}

Parámetros de Ruta

string

required

El ID de validación devuelto al crear la validación KYC

Respuesta

{
  "id": "550e8400-e29b-41d4-a716-446655440000",
  "entityId": "123e4567-e89b-12d3-a456-426614174000",
  "providerSessionUrl": "https://verify.example.com/session_xyz789",
  "status": "pending",
  
  "isCurrent": true,
  "createdAt": "2025-01-15T10:30:00Z",
  "updatedAt": "2025-01-15T10:30:00Z"
}

Valores posibles de status

El campo status puede ser: pending, in_progress, in_review, approved, rejected, expired, abandoned, cancelled. Consulta Verificar estado para la descripción de cada uno.

Ejemplo

const validationId = '550e8400-e29b-41d4-a716-446655440000';

const response = await fetch(
  `https://api.gu1.ai/api/kyc/validations/${validationId}`,
  {
    headers: {
      'Authorization': 'Bearer TU_API_KEY'
    }
  }
);

const validation = await response.json();
const urlVerificacion = validation.providerSessionUrl;
console.log('Comparte esta URL con tu cliente:', urlVerificacion);

validation_id = '550e8400-e29b-41d4-a716-446655440000'

response = requests.get(
    f'https://api.gu1.ai/api/kyc/validations/{validation_id}',
    headers={'Authorization': 'Bearer TU_API_KEY'}
)

validation = response.json()
url_verificacion = validation['providerSessionUrl']
print('Comparte esta URL con tu cliente:', url_verificacion)

Alternativa: Obtener Validación Actual por Entidad

Si no tienes el ID de validación pero tienes el ID de entidad:

GET https://api.gu1.ai/api/kyc/entities/{entityId}/current

Compartir la URL con Clientes

Ejemplo de Email

<p>Hola {{nombreCliente}},</p>
<p>Por favor completa tu verificación de identidad para continuar:</p>
<p><a href="{{providerSessionUrl}}">Verificar Tu Identidad</a></p>
<p>Este enlace expirará en 7 días.</p>

Ejemplo de SMS

Completa tu verificación de identidad aquí: {{providerSessionUrl}}

Integración en App

// Redirigir usuario a verificación
window.location.href = providerSessionUrl;

// O abrir en nueva ventana
window.open(providerSessionUrl, '_blank');

// O embeber en iframe
<iframe src={providerSessionUrl} width="100%" height="600px" />

Próximos Pasos

Integración Webhook

Recibir actualizaciones en tiempo real

Verificar Estado

Consultar resultados de validación

⌘I

​Resumen

​Cuándo Usar Esto

​Solicitud

​Endpoint

​Parámetros de Ruta

​Respuesta

​Valores posibles de status

​Ejemplo

​Alternativa: Obtener Validación Actual por Entidad

​Compartir la URL con Clientes

​Ejemplo de Email

​Ejemplo de SMS

​Integración en App

​Próximos Pasos